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and Tool set, and individual documentation for each Oracle 
product you have licensed. 

The Oracle Server for UNIX Administrator's Reference Guide you are 
reading is intended for use with your UNIX-based operating 
system and contains technical administration and usage 
information about the Oracle Server. Information about Oracle 
Tools administration and use on the UNIX operating system is 
contained in the Oracle Tools for UNIX Administrator's Reference 
Guide. 

Once you have installed and configured the Oracle Server and 
any tools you have licensed, refer to the individual product 
documentation for usage and feature information. 
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TT his Oracle Server for UNIX Administrator's Reference Guide contains 
reference information that applies to all UNIX-based operating systems. 
It complements the Oracle Installation & Configuration Guide (ICG) 
specific to your UNIX-based operating system. 

The topics covered in this chapter are: 

• audience 

• manual organization 

• Oracle for UNIX documentation set 

• related Oracle publications 

• document conventions 

• customer support 
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This manual is written for those who administer the operation of an 
Oracle database on UNIX-vased operating systems. These persons, 
referred to as database administrators (DBAs), are responsible for 
ensuring the smooth operation of an Oracle database system and for 
monitoring ifs use. 

Readers of this guide are assumed to be familiar with relational 
database concepts. They are also assumed to have fundamental 
knowledge of the UNIX-based operating system environment under 
which they are running Oracle. 

As a prerequisite, all readers should read the first chapter of the Oracle7 
Server Concepts Manual "A Technical Introduction to the Oracle Server ". 
This chapter is a comprehensive introduction to the concepts and 
terminology used throughout this guide. In general, readers also should 
be familiar with all of the related Oracle Server publications listed later 
in this chapter. 



Manual Organization 


This guide is divided into three parts, organized as follows: 


Part I: Database Administration 

Oracle System Architecture under UNIX 

This chapter describes the architecture, processes, structures, and other 
concepts of Oracle as they apply to UNIX. 

Oracle System Administration 

This chapter explains how to administer Oracle on UNIX-based systems, 
and contains information on security, roles and groups, environment 
variables, and trace files. 

Backing Up and Recovering a Database 

This chapter explains how to archive the redo log files, how to protect an 
Oracle database from possible failures, and how to recover from failure. 

Planning a Complex Database on UNIX 

This chapter discusses the basic concepts of planning and building an 
Oracle database. In particular, assessing space needs, temporary and 
rollback segments, and the default UNIX init.ora file are discussed. 

Monitoring and Tuning Your Oracle System 

This chapter explains how to avoid I/O bottlenecks, how to reduce 
contention for rollback segments, and performance-related aspects of the 
Oracle Server. 


Part II: Server Additions 


Oracle XA Library 

This chapter describes the features of the XA Library and expolains how 
to use this interface. 


Part III: UNIX Reference 


UNIX Messages 

This chapter lists Oracle messages specific to UNIX-based operating 
systems, describes the probable cause of each, and suggests actions you 
can take to resolve problems. 
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Appendices 


Appendix A: Diagnosing and Solving Problems 

This appendix provides troubleshooting tips to help you resolve 
problems you may encounter. 

Appendix B: Environment Variables 

This appendix provides a list of the environment variables you will use 
to create the optimum operating-system environment in which to run 
Oracle. 


% 


IV 


Oracle7 for UNIX 


The Oracle for UNIX Documentation Set 

In addition to this UNIX manual, you will feceive two additional 
UNIX-related Oracle documents. 


Oracle Installation & Configuration Guide (ICG) 

The ICG for your UNIX-based operating system contains installation 
instructions, and also includes important platform-specific information 
on Oracle. Chapter 1 of the ICG contains the following system-specific 
information which is particularly relevant to the topics discussed more 
generally here in the SARG. 

• system requirements for Oracle on your platform 

• Oracle tools requirements on your platform 

• disk space and memory requirements 

• platform-specific issues such as shared memory operations, block 
and file size, support for the Oracle Parallel Server option, and 
filename and environment variable default values 

• platform-specific restrictions 

• UNIX restrictions 


Oracle Tools for UNIX Administrator's Reference Guide (TARG) 

This guide provides UNIX-generic information regarding the use and 
administration of Oracle tools for both Oracle Server version 6 and 
Oracle Server version 7. It is supplemented by installation and 
platform-specific information in the ICG for your UNIX-based operating 
system. 

Note: The Oracle for UNIX Systems Error Messages Manual , 
Release 7.0.9, is obsolete. The information presented in that 
manual has been incorporated in this guide. 


Related Oracle Publications 

General information about the Oracle Server for all operating systems is 
contained in the Oracle Server documentation set, which consists of the 
following manuals: 
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Oracle7 Server Concepts Manual 

This manual describes the general Oracle Servef architecture, how 
Oracle Server operates, and how it is intended to be used. It is a 
reference guide designed to educate readers on basic Oracle Server 
concepts. 

Oracle7 Server Utilities User's Guide 

This guide describes the Oracle Server utilities Export, Import, 
SQL*Loader, and SQL*DBA. Changes to the Oracle Server utilities are 
also documented. 

Oracle7 Server Administrator's Guide 

This guide provides procedures for managing a database. 

*Oracle7 Server SQL Language Reference Manual 

This book describes the SQL language as implemented by the Oracle 
Server. 

Oracle7 Server Messages and Codes Manual 

This manual provides complementary information about messages 
generated by the Oracle Server and its integral parts such PL/SQL, 
precompilers, and SQL*Loader. 

Oracle7 Server Migration Guide 

This guide describes the general use of the Migration utility and 
explains how to use the Export and Import utilities to perform an Export 
upgrade. It also provides an appendix summarizing changes in the 
Oracle Server. 

Oracle7 Server Application Developer's Guide 

This guide explains how to create applications such as procedures and 
triggers that run on Oracle Server. Also included are appendices 
describing how to interface with SQL*Forms. 

Oracle7 Parallel Server Administration Guide 

This book documents architecture, administration, and concepts with 
respect to Oracle Parallel Server. 

Oracle Server Documentation Addendum 

This manual documents updates for the 7.1 Beta release of Oracle Server. 
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Document Conventions 


Special Conventions 


Command Syntax 


Conventions used in this manual differ sofnewhat from those used in 
other Oracle documentation, including the generic Oracle Server 
publications listed earlier. Since a AIX 3.2-compliant system is 
case-sensitive, commands and filenames are not highlighted here by the 
use of upper-case letters. Instead, they are printed in boldface type. The 
case used in examples in this manual reflects precisely the way 
information should be entered by the user. The following conventions 
are observed in this manual: 


Bold 

[CAPITALS] 

PLAIN 

CAPITALS 


Boldface type is used to denote UNIX filenames, as 
in init.ora, directory names, path names, and 
commands. Portions of the file name that may vary 
appear in italics, as in sgadefx.dbf. 

Key names are represented by capital letters 
enclosed in square brackets, as in [RETURN]. 

Oracle commands, including SQL product 
commands, are represented by capital letters, as in 
ALTER DATABASE. 


monospace 


italics 


Vertical lines I 


Curly braces { } 


Brackets 


Monospace is used for text that must be entered 
exactly as shown: 

set echo off 

Italics is used for variables in the text and for 
emphasis. In examples, variables are shown in 
italics. Substitute an appropriate value. 

argl 

Vertical lines are used for alternative choices. The 
set of alternative choices is enclosed by curly braces 
if one of the items is required, or by square brackets 
if the item is an optional alternative. 

Curly braces are used for required items. Users 
must choose one of the alternatives. 

.DEFINE { macro 1 I macro2 } 

Square brackets are used for optional items. 
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cvtcrt termname [ outfile ] 


Ellipsis ... Ellipses are used for an arbitrary number of similar 

items. 

CHKVAL fieldname value 1 value2 ... valueN 

The following symbols should always be entered as they appear in the 
command format: 

period 

comma , 
hyphen - 
semicolon ; 
colon : 

equal sign = 
backlash \ 
single quote' 
double quote " 
parentheses () 


Other Conventions 

Note the following usage of the term "oracle": 

Oracle or Oracle refers to the relational database product from 
Server Oracle Corporation. 

Oracle refers to Oracle Corporation itself 

oracle refers to the oracle software owner 

oracle refers to an executable or account by that name 

Unless otherwise stated, examples use the Bourne shell (sh(l)) syntax. 

All references made throughout this book to specific chapters refer to 
chapters in this SARG, except where noted. 


Special Icons 


Special icons are provided to alert you to particular information within 
the body of this Guide. 

Additional Information: The book symbol highlights a 
1 Oracij reference to another Oracle guide or manual. Where a reference 
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A 



OPS 


is to a manual or document published by some organization 
other than Oracle, you will see tjie words, "Additional 
Information:," but no icon. Where a reference is to chapters 
within a guide, you will see the words, "Additional 
Information," but no icon. 

Warning: The warning symbol highlights text that warns you 
of actions that could be particularly damaging or fatal to your 
system. 

Suggestion: The suggestion symbol highlights 
recommendations and hints. 

For Parallel Server: References to Oracle Parallel Server are 
denoted by this icon. 
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Customer Support 


Oracle Corporation's Worldwide Technical Support Services answer line 
can be reached 24 hours a day. If, after following the instructions in the 
documentation, you need further assistance, please call: 

In the U.S.A.: +1 415 506 1500 

In Europe: + 44 344 860160 

You will be asked a series of questions to help navigate you to the 
correct Oracle product support group. Be prepared to supply the 
following information: 

• your CSI number (this helps Oracle Corporation track problems 
recorded for each customer) 

• the version numbers of the Oracle Server and associated products 

• the operating system name and version number 

• details of error numbers and descriptions (write down the exact 
errors—it will help Oracle Worldwide Technical Support track 
down the problem more quickly) 

• a description of the problem 

Your Comments Are Welcome 

We value your comments as a user of the Oracle Server. As we write, 
revise, and evaluate, your opinions are the most important input we 
receive. Please use the Reader's Comment Form at the back of this 
manual to tell us what you like and dislike about this manual. 
Alternatively, you may contact us at the following address: 

Rita Moran 

Publications Manager, UNIX Product Line Technology 
Oracle Corporation 
500 Oracle Parkway 
Box 659407 

Redwood Shores, California 94065 
U.S.A.(415) 506-2453 

You may contact us by telephone at l-(415)-506-2453. 
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CHAPTER 



1 


Oracle System 
Architecture under 
UNIX 


1 his chapter describes basic structures of the Oracle system 
architecture and key aspects of its implementation under UNIX-based 
operating systems. Throughout this chapter the operating system is 
referred to as "UNIX." Your UNIX-based operating system may have a 
different name. 

The topics covered in this chapter are: 

• Oracle system overview 

• Oracle Server configuration on UNIX 

• memory structures 

• processes 

• directory structure 

• environment variables 

• additional Oracle Server executables 
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Oracle System Overview 

This section briefly reviews the architecture of an Oracle Server 
database. 



Additional Information: For a complete discussion of the 
Oracle Server database, see the Oracle Server Concepts Manual. 


Physical Database Structures 

The physical database structure comprises four types of files: data files, 
redo log files, archived redo log files, and control files. A discussion of 
these files follows. 


Datafiles 

Data files contain all database data. There is at least one data file 
associated with each database. All instances of a multi-instance system 
access the same database files. 

Redo log files 

Redo log files record changes made to data. The recorded changes 
provide roll-forward information for recovery from a media or system 
failure. The set of redo log files for a database is known collectively as 
the database redo log. In a parallel system, each instance maintains its 
own redo log. 

Archived redo log files 

The archived redo log files are copies of the online redo log files you 
store offline. 

Control files 

Control files contain information that identifies and describes the 
database. Each database is identified by a small control file containing 
information such as the database name and timestamp, and the names 
of data and redo log files. 

Each database must have a control file, and each database should 
maintain at least one extra copy of the control file on a separate disk as a 
precaution against media failure. Oracle7 automatically creates three 
copies of the control file on the same disk. Be sure to move at least one 
copy to a separate disk to protect yourself from media failure. 
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For Parallel Server: The control files hold parameter values 
which must be identical for all instances running concurrently. 
As each instance starts up, the Oracle Server compares the 
values in its parameter file with those in the control file, and 
displays an error message if the values are incompatible. 


Logical Database Structures 

The logical database is determined by two components: tablespaces and 
schema objects. In Oracle7, at least five tablespaces are created by 
default. Database schema objects include tables, views, indexes, 
clusters, sequences, and stored procedures. 

Logical storage structures, such as tablespaces and segments, determine 
how the physical space of a database is used. Schema objects, and 
relationships among them, form the relational design of a database. 

The following section describes the logical structures, including 
tablespaces, schema objects, data blocks, extents, and segments. 


Tablespaces 

A database is divided into logical storage units called tablespaces. A 
tablespace consists of one or more operating system files used to group 
related logical structures together. A tablespace can be online 
(accessible) or offline (not accessible). 


Schema objects 

Schema objects are logical structures that directly refer to database data. 
Schema objects include such structures as tables, views, sequences, 
stored procedures, synonyms, indexes, clusters, and database links. 


Data blocks 


An Oracle Server database stores data in data blocks. One data block 
corresponds to a specific number of bytes of physical database space on 
disk. A data block size is specified for each Oracle Server database 
when the database is created. Note that a database block may not be the 
same size as an operating system block. 

Additional Information: For the data block sizes for your 
Q^. le UNIX system, see your ICG. 
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Extents 

An extent is a specific number of contiguous data blocks, obtained in a 
single allocation, used to store a specific type of information. An extent 
is the next level of logical database space. 

Segments 

A segment is a set of extents allocated for a certain logical structure. 

Since extents are allocated as needed, the extents of a segment may or 
may not be contiguous. The different types of segments are: data 
segments, index segments, rollback segments, and temporary segments. 

data segments Each table stores all its data in the extents of its data 

segment. 

index segments Each index stores all its data in an index segment. 

rollback segments Rollback segments contain information required for 
read consistency and to undo changes when 
transactions are rolled back. 

temporary Temporary segments are created by Oracle Server 

segments when a SQL statement, such as SORT BY, needs a 

temporary work area to complete execution. 

Database Options 

The following database options are discussed in this section: 

• distributed option 

• procedural option, PL/SQL v2 

• Oracle Parallel Server option 

Distributed option 

A distributed database is a set of databases that may be physically 
separate, but appear to the user as a single logical database. If you 
configure your database in the distributed option, you can perform 
distributed processing and support distributed database architecture. 

You can use the distributed database option to access and modify the 
data of any and all databases simultaneously. 

The primary benefit of a distributed database is that you can connect 
two instances of a widely separated database and make them potentially 
accessible to all users on the network. Once you create the required 
database links, you can INSERT, DELETE, UPDATE, and SELECT data 
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from tables on the remote database as if the tables were on a local 
database. 

The database administrator must create the SQL*Net links explicitly, by 
performing a SQL statement called CREATE DB LINK. Once this is 
done, transaction integrity and the semantics of COMMIT and 
ROLLBACK are preserved for all operations, including those referring 
to tables on the remote machine. This is the case even if the remote 
database crashes or the networking links connecting the databases go 
down. 


Procedural option: PL/SQL v2 


PL/SQL is the Oracle procedural language extension to SQL. This 
option allows you to mix SQL statements with procedural constructs. 
Use PL/SQL to define and execute PL/SQL program units such as 
procedures, functions, and packages. These program units are generally 
categorized as anonymous blocks and stored procedures. 

Oracle Parallel Server option 


For P ara llel Server: With this option, Oracle Server can run 
OPS multiple instances that "share" a single physical database. 

When used in combination with loosely coupled systems which 
allow multiple computers to share access to data, software, or 
peripheral devices, the Oracle Parallel Server option lets users 
on multiple machines access a single database, thus increasing 
performance. Parallel Server architecture is briefly described in 
the following section, titled "Oracle Server Configuration on 
UNIX." 



Additional Information: For more information about 
installing the Oracle Parallel Server, see the "Planning Your 
Installer Session" chapter of your ICG. For a detailed discussion 
of the Oracle Parallel Server, see the Oracle Parallel Server 
Administrator's Guide. 


The Oracle Parallel Server has the following characteristics: 

• An Oracle Server instance can be started on each node in a loosely 
coupled system. 

• Each instance is a separate System Global Area (SGA) and set of 
background processes. 

• All instances share the same data files and control file. 

• Each instance has its own redo log. 
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• The data files, redo log files, and control file reside on one or more 
disks of the loosely coupled system. 

• All instances can execute transactions concurrently against the 
same database, and each instance can have multiple users 
executing transactions. 

• Row locking is preserved. 

The following figure illustrates the Oracle Server running in parallel 
mode on a loosely coupled system, with three instances on separate 
nodes accessing the database. 


High-speed bus 



Figure 1-1 Parallel Mode Sharing Disks 
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Oracle Server Utilities 


The following Oracle Server utilities are discussed in this section: 

• SQL*Loader 

• Export and Import utilities 

Additional Information: For more information on SQL*Loader 
and the Export and Import utilities, see the Oracle Server Utilities 
User's Guide. 

SQL*Loader 

SQL*Loader is used to move data from external files into tables in an 
Oracle Server database. It loads data in a variety of formats, filters data, 
and can load multiple tables simultaneously. 

Note that the Oracle Server incorporates SQL*Loader functionality. 
There are no separate loader directories with the Oracle Server. 
Demonstrations and message files are under the rdbms directory. 

Export and Import utilities 

Export and Import are utilities used to move Oracle Server data in and 
out of Oracle Server databases. Export writes data from an Oracle 
Server database to operating system files in an Oracle Server file format. 
Import reads Export files and restores the corresponding information 
into an existing database. You can use Export and Import as a 
supplemental method of protecting data in an Oracle Server database. 

Additional Information: For more information about Export 
and Import, and protecting data, see the "Backing Up and 
Recovering a Database," chapter. 
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Oracle Server Configuration on UNIX 


Overview 

The building blocks of system intercommunications comprise server 
processes, user processes, background processes, and a program 
interface. This section begins with an overview of these configuration 
components, then goes on to describe various configurations of Oracle 
Server on UNIX systems in which the client and server can 
communicate. 

• two-task 

• multi-threaded server 

• single-task 

Server processes 

The Oracle Server creates server processes to handle requests from 
connected user processes. Each server process interacts with the Oracle 
Server data structures in order to carry out requests of the associated 
user process, then communicates the results to the user process. 

You can configure the Oracle Server to vary the number of user 
processes per server process. In a dedicated server configuration, a 
server process handles requests for a single user process. In a 
multi-threaded server configuration, a small number of server processes 
handle requests for many user processes, thus minimizing the number 
of server processes and maximizing the use of available system 
resources. 

User (client) processes 

User processes are application programs (such as a Pro*C program) or 
Oracle Server tools. User processes also manage communication with 
server processes, using the program interface. 

Background processes 

Background processes include SMON, PMON, LCK, DBWR, and 

LGWR, as well as optional processes such as dispatchers, DBWR slaves, 
shared servers, WMON, ARCH, RECO, and CKPT. Note that you can 
only use RECO if you have enabled the distributed database option. 
Also, note that WMON is available only on some platforms. Refer to 
your ICG to determine which background processes your platform 
includes. 
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Additional Information: For more information on background 
processes and their functions, see the Oracle7 Server Concepts 
Manual and the Oracle7 Server Administrator's Guide. 


Program interfaces 

The program interface is the mechanism by which a user process 
communicates with a server process. It performs conversions and 
translations of data (particularly between different types of computers). 
If the user and server processes are on different computers of a network, 
or if the user processes connect to shared server processes through 
dispatcher processes, the program interface includes the physical 
connection, the communications software, and SQL*Net. 

Additional Information: For detailed information about 
program interfaces, see the Oracle Server Concepts Manual. 
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The two-task configuration provides a one-to-one ratio between the user 
process and the server, or shadow, process. The "two-task" designation 
means each application "task" is associated with a corresponding server 
"task" (process). The server and the user talk to each other through a 
network connection such as TCP/IP, or through UNIX pipes (if the 
processes are on the same machine). This configuration is termed 
"dedicated-server"; if the client, or front-end process, is located on a 
different machine, the configuration is termed "client-server," as 
opposed to the multi-threaded server configuration. 

Note: Multi-threaded server architecture also supports the 

client-server configuration. 

The Oracle Server kernel is a shared text executable. Because of this the 
text is mapped into memory only once. All server and background 
processes share the same text segment, and each uses its own private 
data segment and stack segment to keep track of its own place (context) 
in the program. 



Additional Information: The two-task implementation also 
provides important security and networking capabilities. For 
more information on the security aspects of the two-task 
configuration, see the "Managing Security" section in the 
"Oracle System Administration" chapter. 

Additional Information: For information on choosing a 
two-task driver, see the section "Deciding Which Driver to Use" 
in the "SQL*'Net vl Overview" chapter of the TARG. 











TWO-TASK 

IMPLANTA¬ 

TION 


j User | 

Figure 1-2 Two-Task Configuration 
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Various SQL*Net and two-task drivers are available for communication 
between user processes and Oracle Server processes. Depending on 
your platform, these drivers may include: 

• vl SQL*Net Asynchronous driver 

• vl SQL*Net Pipe driver 

• vl SQL*Net DECnet driver 

• vl SQL*Net LU6.2 driver 

• vl SQL*Net TCP/IP driver 

• vl SQL*Net TCP/TLI driver 

• vl SQL*Net SPX/IPX driver 

• vl SQL*Net X.25 driver 

• v2 Oracle IPC protocol adapter 

• v2 Oracle BEQ protocol adapter 

• v2 Oracle OSI4 protocol adapter 

• v2 Oracle TCP/IP protocol adapter 

• v2 Oracle DECnet protocol adapter 

• v2 Oracle SPX protocol adapter 

You can easily switch from one two-task driver to another to optimize 
the performance of particular tasks. 

Additional Information: See the following manuals for 
lo~iJ additional information. 

• For information on how to specify two-task drivers, see the 
chapters on networking and drivers in the Oracle Tools for UNIX 
Administrator's Reference Guide ( TARG ). 

• For more information about the connection manager and 
navigator, see the Multiprotocol Interchange Administrator's Guide , 
vl. 


• Oracle Server version 7: For more information about SQL*Net v2 
protocol adapters, see the SQL*Net.v2 Administrator's Guide. 

• Oracle Server release 7.1: For more information about SQL*Net 
r2.1 protocol adapters, see Understanding SQL*Net and the Oracle 
Network Manager Administrator's Guide. 









In a single-task configuration, the user program, the Oracle Server 
kernel, and the program interface all run as part of the same process, as 
illustrated in the following figure. This configuration of Oracle Server is 
not generally recommended for UNIX-based platforms. It is designed 
for use only on operating systems (such as VMS) that can provide the 
required separation or barrier (also known as process rings) between 
application code and the Oracle Server code. 

On systems such as UNIX, where separation between application code 
and server code cannot be maintained by the operating system, errors in 
application code, such as incorrect pointers, can result in damage to the 
SGA and corruption of data in the database. For this reason, Oracle 
Corporation normally does not support single-task linking for 
application code not distributed by Oracle. By contrast, certain Oracle 
products can be linked effectively in a single-task configuration. 
SQL*Loader, for example, can be linked single-task to achieve 
performance gains for data loading. Import and export of data can also 
be faster using a single-task configuration. 

However, you should balance any gains in speed against the fact that 
single-task configuration may have higher memory requirements than 
two-task or multi-threaded server configuration. 

Note that Oracle Corporation no longer supports single-task 
architecture for any Oracle Tools except Import, Export, SQL*DBA, and 
SQL*Loader. 
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Figure 1-3 Oracle Server on Platforms Supporting Single-Task Architecture 


The preceding figure shows the Oracle Server using combined 
user/server processes on platforms supporting single-task architecture. 


For information on using single-task applications, see the "Oracle Server 
System Administration" chapter. 



Additional Information: For more information about 
single-task, two-task, and multi-threaded servers, see the Oracle 
Server Concepts Manual. 






























Multi-Threaded Server 

The multi-threaded server configuration allows many user processes to 
share a small number of server processes, minimizing the number of 
server processes and maximizing the utilization of available system 
resources. 

As illustrated in the following figure, the multi-threaded server 
configuration allows multiple clients to connect through dispatchers to 
the Oracle Server. The user process sends a request to its dispatcher, 
and the dispatcher submits the request to the request queue in the SGA. 
The next available server process services the user's request, and returns 
results to the calling dispatcher's response queue in the SGA. The 
dispatcher takes the response from the response queue and returns it to 
the appropriate user. Note that the multi-threaded server configuration 
also allows individual clients to connect to dedicated servers via pipes 
or standard communications protocols such as TCP/IP. 




Additional Information: Most SQL*Net r2.1 adapters can be 
used for multi-threaded server connections on UNIX. To do so, 
configure the initora and listener.ora files as described in the 
corresponding adapter chapter in the TARG. 
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Memory Structures 

This section provides a brief overview of the memory structures used by 
the Oracle Server to manage a database. 

An Oracle Server Instance 

Every running Oracle Server is associated with an Oracle Server 
instance. Every time a database is started on a database server, a 
memory area called the System Global Area (SGA) is allocated and one 
or more Oracle Server processes are started. The combination of the 
SGA and the Oracle Server processes is called an Oracle Server instance. 
An illustration of an Oracle Server instance follows, together with a 
discussion of each major element of the instance. 
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Figure 1-5 An Oracle Server Instance 
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Program Global Area 


System Global Area 


The Program Global Area (PGA) is a memory buffer that contains data 
and control information for a server process. The PGA is a non-shared 
memory area to which a process can write. One PGA is allocated for 
each server process; the PGA is exclusive to a server process, and read 
and written only by Oracle Server code acting on behalf of that process. 

A PGA is allocated by Oracle Server when a user process connects to an 
Oracle Server database and a session is created, although this varies by 
operating system and configuration. The contents of a PGA vary, 
depending on whether the associated instance is running the 
multi-threaded server. For example, the user session and cursor state 
will be allocated in the PGA in the dedicated server and in the SGA for 
the multi-threaded server. 



Additional Information: For more information on the PGA, 
see the Oracle Server Concepts Manual. 


All Oracle Server operations use data stored in an area of shared 
memory called the System Global Area (SGA). Oracle uses the SGA for 
communication among the various Oracle processes. 

The SGA memory buffers hold data and control information for a single 
Oracle Server database instance. An SGA, together with the Oracle 
Server background processes, constitute an Oracle Server database 
instance. The SGA is allocated by the Oracle Server when an instance is 
started and de-allocated when the instance is shut down. Each instance 
that is started has its own SGA. 



For Parallel Server: The coordination of multiple SGAs is 
regulated by the Oracle Server parallel cache management 
facility. 


The data in the SGA is shared among the users currently connected to 
the database. The information stored within the SGA is divided into 
several types of memory structures, including: 

• database buffers 


• redo log buffers 

• shared pool 


• cursors 

The following section describes memory structures in more detail. 
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Database buffers 



The database buffers in the SGA store the most recently used blocks of 
database data, and these buffers can contain modified data that has not 
yet been permanently written to disk. Storing the most recently used 
data in memory reduces the need for I/O, thus increasing database 
system performance. 

When an instance and its SGA are created, a static number of database 
buffers are created, as specified during instance startup. These buffers 
exist as long as the instance remains. 

Redo log buffers 

The redo log buffer of the SGA stores redo entries comprising a log of 
changes made to the database. Entries stored in the redo log buffers are 
written to an online redo log file, which is used if database recovery is 
necessary. The redo log buffer is created during instance startup and its 
size is static as long as the instance remains in operation. 

Shared pool 

The shared pool is an area in the SGA that contains shared memory 
constructs such as shared SQL areas. A shared SQL area is required to 
process every unique SQL statement submitted to a database, and 
contains information such as the parse tree and execution plan for the 
corresponding statement. A single shared SQL area is used by multiple 
applications that issue the same statement, leaving more memory in the 
pool for other uses. 

Cursors 

A cursor is a handle for the memory associated with a specific 
statement. For example, a cursor is a name or pointer to the memory 
used to process a specific SQL statement. Although most Oracle Server 
users rely on the automatic cursor handling of the Oracle Server utilities, 
the programmatic interfaces offer application designers more control 
over cursors. 

For example, in precompiler application development, a cursor is a 
named resource available to a program and can be used specifically for 
the parsing of SQL statements embedded within the application. The 
application developer can code an application so that it controls the 
phases of SQL statement execution, thus improving application 
performance. 
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The size and characteristics of the SGA are determined by the set of 
start-up parameters found in the inits/d.ora file (discussed later in this 
section). Every time an Oracle Server instance is started, this file is 
referenced. 

The SGA is mapped in a fixed location in the address space of an Oracle 
Server process. The Oracle Server system allocates shared memory 
regions to form the SGA according to the sizes specified by init.ora 
parameters. By adjusting certain parameters, you can increase or 
decrease the size of the SGA, thus affecting the performance of the 
Oracle Server. To edit these parameters, first use the SQL*DBA utility to 
shut down the Oracle Server instance, and then modify the values in the 
inits/d.ora file. 


At instance startup, you can use the PFILE option of the STARTUP 
command to specify a parameter file for a specific instance. 

Since the init.ora parameters determine the use of Oracle Server 
resources by the processes that execute in the SGA, as well as the 
amount of data that must be maintained in the SGA, they also determine 
the memory space needed to support these requirements. While 
increasing the value of init.ora parameters may improve performance, 
performance may suffer if the SGA is so large that it must be paged in 
and out of memory. 

You must, therefore, bear in mind the amount of physical memory on 
your system and add memory as the size of your SGA increases. For 
optimal performance, the entire SGA should be large enough to store as 
much data as possible in memory and minimize disk I/O. However, do 
not make the SGA so large that it must be paged to disk. Doing so 
defeats the purpose of having an SGA, which is to keep frequently 
processed data in RAM rather than on disk. 


On machines which are devoted entirely to Oracle Server, a starting 
point for general applications would be to allocate one-third of the 
physical RAM for the SGA (that is, for the sum of all the SGAs on the 
system). If your system must support a large number of users or a 
heavily loaded application other than Oracle, a larger SGA may be 
necessary. 



Additional Information: For more information on relocating 
the SGA, see the "Oracle Server Administration on UNIX" 
chapter of your ICG. 













Creation of the SGA: the inits/d.ora file 


When an instance starts up, the Oracle Server uses the parameter values 
found in the initszd.ora file to create the SGA for that instance. The 
unique combination of Oracle home and Oracle sid identifies a startup 
file. 


For Parallel Server: On a multi-instance Oracle Server system, 
some init.ora parameters must have the same values for all 
instances. For example, since all instances share the control 
files, each inits/d.ora file must have the same filename(s) for the 
control_file parameter. 

Each Oracle Server instance on a parallel system can have an individual 
initszd.ora file, or several instance can share an inits/rf.ora file. Instances 
that have individual inits/d.ora files can include a set of common 
parameter values by using the ifile parameter. Every instance that uses 
private rollback segments must have its own inits/d.ora file, but 
instances that only use public rollback segments can share a single 
inits/rf.ora file. 



Additional Information: For more information on displaying 
the value of the initialization parameters, see the Oracle Server 
Administrator's Guide. 
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Processes 



A process is a mechanism in an operating system that can execute a 
series of steps. Some operating systems use the terms job or task. A 
process normally has its own private memory area in which it runs. 

The Kernel 

The kernel (the oracle executable) is the part of the Oracle Server that 
performs SQL operations requested by users. It performs reads and 
writes to the database and log files, maintains data in the SGA, and 
coordinates the activities of multiple users. 

The oracle executable is invoked with a large number of different 
names. All the background processes, the shadow processes, and all the 
shared server processes are invocations of the same oracle executable. 

In the two-task configuration of Oracle, when a user process (such as a 
user-written application program or a utility program like SQL*Plus) 
logs onto an Oracle Server system, a server process (the oracle program) 
is invoked to access the Oracle Server system database. The user 
process communicates with the user; the oracle process attaches to the 
SGA and accesses the database. If two or more users are running the 
same utility or application program, the text segment of that program is 
shared among all processes running that program. 

Background Processes 

The Oracle Server creates a set of background or detached processes 
automatically when an instance is started. These processes consolidate 
functions that would otherwise be handled by multiple Oracle Server 
programs running for each user process. The background processes 
asynchronously perform I/O and monitor other Oracle Server processes 
to provide increased parallelism for better performance and reliability. 

A figure illustrating the background processes, and a brief description, 
follow. 
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Figure 1-6 Oracle Server Background Processes 


The archiver process, ARCH, archives the online redo log files. It is 
active only when the redo log is used in ARCHIVELOG mode and 
archiving is enabled. 

For Parallel Server: Archiving is done on a per-instance basis 
OPS and can be either manual or automatic. Instances running 
concurrently should all archive by the same method, either 
automatically or manually. 


The checkpoint process, CKPT, is responsible for signalling DBWR at 
checkpoints and updating all data files and control files of the database 
to indicate the most recent checkpoint. The CKPT process is optional; if 
it is not present, LGWR assumes the responsibilities of CKPT. 

To enable CKPT, set the initialization parameter checkpoint_process to 
true. 


The database writer, DBWR, writes modified blocks from the database 
buffer cache to the database. In a parallel system, the DBWR process of 
each instance writes blocks to disk when they are required by other 
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LCKh 


instances. Notification that they are required is handled by the 
distributed lock manager. 



For Parallel Server: If you are running the Oracle Parallel 
Server option, note that the lock process LCK /7 uses the 
distributed lock manager to prevent simultaneous changes to 
the same data, by coordinating the buffer caches of all SGAs. 
One lock process, LCKO, should be sufficient, but additional 
processes, LCK1 to LCK9, are available for systems with 
exceptionally high throughput. 

Note: The LCK process only applies if you are running the 
Oracle Parallel Server option. 


LGWR 


PMON 


RECO 


SMON 


The log writer, LGWR, allocates space in redo log files and writes redo 
log entries to disk. 

The log writer process can handle checkpointing, but if you allow it to 
do so, your system performance may be degraded during a checkpoint. 
The optional checkpoint process takes over responsibility for updating 
control file and database file headers after a checkpoint. This will 
improve performance by leaving the log writer process free after writing 
the log files to disk. 


The process monitor, PMON, performs process recovery when a user 
process fails. It also cleans up the cache and frees resources that the 
process was using. 


The distributed transaction recovery process, RECO, resolves 
distributed transactions that are pending due to a network or system 
failure in a distributed database. 

Note: RECO is only active if the distribution option is enabled. 


The system monitor, SMON, performs instance recovery and cleans up 
temporary segments that are no longer in use. 
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For Parallel Server: In a parallel system, the SMON process 
performs instance recovery for other instances. After an 
instance fails, the SMON process of another instance rolls 
forward any committed work not written to disk, rolls back 
incomplete transactions, and frees locked resources. 

WMON 

The wakeup monitor, WMON, is used to reduce the amount of alarm 
signal handling that a process must perform. To enable WMON, set the 
initialization parameter reduce_alarm to true. Note that WMON is not 
required, and therefore is not supported on some UNIX platforms. 

Multi-threaded server background processes 

To maximize performance and accommodate many users, an Oracle 
multi-threaded server system uses the following additional background 
processes: 

dOOO to dnnn Dispatcher processes dOOO to dnnn are used in 

multi-threaded server configurations and allow 
many clients to share a small number of servers. At 
least one dispatcher process is created for every 
communication protocol in use (dOOO, ..., dnnn). 

The number of dispatcher processes is configured in 
the mts_dispatchers parameter of the init. ora file. 

sOOO to snnn The multi-threaded server servers are sOOO through 

s nnn. These are Oracle Servers that can be shared 
by more than one client program. The maximum 
number of server processes is configured in the 
mts_max_servers parameter of the inits/d.ora file. 






Additional Information: For more information about 
background processes, see the Oracle Server Concepts Manual. 

Additional Information: Oracle Server version 7: For more 
information about dispatchers, see the SQL*Net vl 
Administrator's Guide. 

Additional Information: Oracle Server release 7.1: For more 
information about dispatchers, see Understanding SQL*Net and 
the Oracle Network Manager Administrator's Guide. 


Additional Server Processes 

In addition to the background processes listed above, a number of 
server processes may also be present on the Oracle Server side. These 
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server processes are used in networking environments to accept 
connection requests from SQL*Net clients. The following additional 
Oracle Server processes may exist, depending on the networking drivers 
available for your platform. 

intlsnr This is the SQL*Net v2 Multiprotocol Interchange 


intpump 

listener that includes the connection manager which 
detects incoming connections. 

This is the process name of a data pump forked by 
intlsnr. The data pump sends the message to its 
destination. 

navgatr 

This is the process name of the SQL*Net v2 
Interchange Navigator, which selects the best 
connection paths for connections that span 
communities. 

orapop 

On some systems, when the Pipe two-task driver is 
being used with out-of-band breaks, the orapop 
executable relays signals from an Oracle Server 
process to an Oracle Server application. 

orasrv 

The SQL*Net TCP/IP implementation uses this 
server program to accept connection requests from 
SQL*Net vl clients. 

tcptlisrv 

The SQL*Net TCP/TLI implementation uses this 
server program to accept connection requests from 
SQL*Net vl clients. 

tnslsnr 

This is the listener process that listens for incoming 
SQL*Net v2 connections. 

dntsrv 

The SQL*Net DECnet implementation uses this 
server program to accept connection requests from 
SQL*Net clients. 

spxsrv 

The SQL*Net SPX/IPX implementation uses this 
server program to accept connection requests from 
SQL*Net clients. 








Directory Structure 


ORACLE_HOME Directory 

Under UNIX, the ORACLE_HOME directory contains the following 
subdirectories, as well as one subdirectory for each additional product 
you have purchased from Oracle Corporation: 


bin 

binaries for all products 

dbs 

initszd.ora and sql.bsq files, and database data files 

orainst 

master installation files and programs 

lib 

Oracle product libraries 

rdbms 

server files and libraries required for the database 


Oracle Product Subdirectories 

Product subdirectories may include any of the following, depending on 
which Oracle products are available for your system, and which 
products you have purchased: 


async 

SQL*Net vl Async 

book 

Oracle Book 

calc 

SQL*Calc 

cdes 

CASE*Designer 

cgen20 

CASE*Generator v2 

cmx 

SQL*Net CMX 

dataq 

Oracle Data Query 

dataq3 

Oracle Data Query 

dbup 

program which checks to see if the database is up 

dcm 

SQL*Net DCM 

ddbo 

installation scripts for distributed option 

dict50 

CASE*Dictionary v5 

dnt 

SQL*Net vl DECnet 

dntpa 

Oracle DECnet Protocol Adapter 

easy 

Easy*SQL 

forms30 

SQL*Forms v3 
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forms40 

Oracle Forms v4 

guicommon 

libraries, resource files, scripts, and message files 
used by several GUI products 

graphics20 

Oracle Graphics v2 

ipa 

loader 

SQL*Net IPA 

SQL*Loader 

lu62 

SQL*Net APPC/LU6.2 vl 

lu62pa 

mail 

APPC/LU6.2 Protocol Adapter 

Oracle*Mail 

menu5 

SQL*Menu v5 

network 

SQL*Net v2 

nmp 

SQ:*Net Named Pipes 

nmppa 

SQL*Net Named Pipes Protocol Adapter 

ocommon 

libraries and SQL messages. All products depend 
on this directory, which is installed automatically. 

olinet 

SQL*Net OLINET-LAN 

orakit 

Oracle Toolkit vl 

oraterm 

Oracle*Terminal 

ORCA 

scripting language used by the Oracle Installer 

osi4pa 

oslan 

Oracle OSI4 Protocol Adapter 

SQL*Net OSLAN 

plsql 

proada 

PL/SQL v2, procedural option 

Pro* Ada 

proc 

procl6 

proc20 

procob 

Pro*C 

Pro*C rl.6 

Pro*C v2 

Pro*COBOL 

procore 

Core script with extensions for C, Ada, COBOL, 
FORTRAN, Pascal 

profor 

Pro*FORTRAN 

propas 

Pro*Pascal 












pso 

install scripts from Oracle Parallel Server option 

qmx 

rdbms 

SQL*QMX 

Oracle Server 

report 

reports20 

SQL*Report 

Oracle Reports v2 

spx 

SQL*Net SPX/IPX 

spxpa 

sqlcalc 

sqlplus 

sqlreport 

sqltr2 

tcp 

tcppa 

tk2 

Oracle SPX/IPX Protocol Adapter 

SQL*Calc 

SQL*Plus 

SQL^ Report Writer 

SQL*TextRetrieval v2 

SQL*Net vl TCP/IP 

Oracle TCP/IP Protocol Adapter 
a link to the Toolkit II directory, guicommon/tk2 

udspa 

UDS Protocol Adapter 

xa 

Oracle XA Library 

xns 

SQL*Net XNS/TOWERNET 

x25tli 

SQL*Net X.25/TLI 

Contents of Product Subdirectories 



Each product subdirectory contains various other subdirectories which 
may include any of the following: 

admin administrative SQL and shell scripts (for example. 


admin/* 

catalog.sql, catexp.sql, and demo.sql) 

other product-specific special directories 

admin/resource 

resource files 

admin/terminal 

run time terminal files 

demo 

demonstration scripts and data files 

doc 

README files (for example, readmeunix.doc) 

install 

product installation scripts 

lib 

product libraries and distributed makefiles 
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log 


trace files and log files (for example, orasrv.log and 
*.trc files) 

mesg U.S. message files, and Multilingual Option 

(formerly National Language Support) message text 
and binary files (for example, oraus.msg and 
oraus.msb) 


Some examples of product subdirectories and their contents are: 


proc 

install, demo, lib 

report 

install, demo, lib 

rdbms 

install, lib, admin, doc, mesg, log 

sqlplus 

install, demo, lib, admin 

tcp 

install, lib 











File Naming Conventions in the admin Directory 

A consistent naming convention exists for supplied SQL scripts in the 
rdbms/admin directory. 

cat*.sql creates catalog and data dictionary tables and 

views. The following three cat*.sql files are run 
automatically during installation. 


catalog.sql 

catproc.sql 

catparr.sql 

dbms*.sql 

utl*.sql 


•for all installations 

for the procedural option installation 

for the Parallel Server option installation 

additional database packages 

creates tables and views for various database 
utilities 


Filename Extensions 

A list of filename extensions and their contents follows: 


.a 

object file libraries; Ada runtime libraries 

.ada 

Ada source files 

.aud 

Oracle audit file 

.bdf 

Xll font description file 

.bmp 

XI1 bitmap file 

.c 

C source file 

.cnv 

SQL source file for CASE conversion 

.ctl 

SQL*Loader control file; Oracle Server control file 

.dat 

SQL*Loader data file 

.ctl 

SQL*Loader control file; Oracle Server control file 

.dat 

SQL*Loader data file 

.dbf 

Oracle Server tablespace file 

.dei 

ORCA de-installation script 

.dmm 

SQL*Menu v5 binary file 

.dmp 

Export file 

.doc 

ASCII text file 

.env 

shell script file for setting environment 
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.f 

FORTRAN source file 

.frm 

SQL*Forms v3 binary file 

.h 

C header file; also, sr.h is a SQL*Report Writer help 
file 

.inp 

SQL*Forms v3 ASCII file 

.ins 

ORCA installation script 

.kdf 

SQL*ReportWriter & Oracle Mail keyboard 
definition file 

.key 

SQL*ReportWriter & Oracle Mail keyboard help file 

.1 

UNIX manual page 

.lis 

output of SQL*PLUS scripts 

.log 

installation log files; Oracle Server redo log files 

.map 

Installer product component files 

.mk 

make files 

.mnu 

SQL*Menu v5 ASCII file 

.msb 

NLS message file (binary) 

.msg 

NLS message file (text) 

.0 

object module 

.ora 

init.ora file; lisnr.ora file; kbcus.ora file 

.ore 

installation prototype files 

.pad 

Pro*Ada source file 

.pc 

Pro*C source file 

.pco 

Pro*COBOL source file 

•PPd 

printer driver file 

.pfo 

Pro*FORTRAN source file 

.prd 

product registration template file (for orainst) 

.r 

Toolkit I resource file 

.ref 

SQL*Forms v3 keyboard "reference card" 

.rep 

SQL*ReportWriter binary file 

.res 

Toolkit II resource file 

.rex 

SQL*ReportWriter ASCII file 





rpt 

SQL*Report ASCII file 

sh 

Bourne shell script file 

sql 

SQL* script files 

sys 

Bourne shell script file 

tab 

SQL* script file 

tut 

Bourne shell script file 

us 

orainst message file 

utd 

Uniform Terminal Definitions 

vrf 

Installer dependencies verification script 
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Environment Variables 


Each process on a UNIX system is created with an "environment" 
consisting of a set of named variables. The process may use these 
variables and obtain their values during its execution. Environment 
variables are shell variables whose values have been made part of the 
environment through the shell export command (export in the Bourne 
shell or setenv in the C shell). 

All environment variables used by Oracle Server must be set in your 
environment and exported through the shell. See sh (or csh) in the 
operating system documentation for more information on exporting 
environment variables. The next chapter, "Oracle Server System 
Administration," also explains how to display and change the values of 
environment variables. 

Note that the routines oraenv (for Bourne shell users) and coraenv (for 
C shell users) can be used to set a common environment for all users; 
these routines are described in the section "Key Oracle Server 
Executables" later in this chapter. 

This section describes some of the key environment variables used by 
the Oracle Server system. 

Additional Information: For more information on 
|o~iJ environment variables used primarily at installation, see the 
"Pre-Installation" chapter of your ICG. For a complete list of 
UNIX environment variables used by Oracle Server and other 
Oracle products, see Appendix B in this SARG. 


Differentiating Oracle Server Systems 

ORACLEHOME and ORACLE_SID are the key environment variables 
used by your Oracle Server system. They uniquely identify each Oracle 
Server database and its root directory. The combination of 
ORACLE_HOME and ORACLE_SID must be unique for each Oracle 
Server instance. 

Note that you can have two instances on the same machine, which share 
the same ORACLE JHOME, but have different values for ORACLE_SIU. 
If you want to test new versions of executables on a test database, Oracle 
Corporation recommends you use a different ORACLE HOME. The 
following example shows you how the combination of 
ORACLEJHOME and ORACLE_SID identify a database instance, and 
the consequences of having varying combinations of values for these 
environment variables. 
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Same ORACLE_HOME, different ORACLE_SID 


ORACLE_HOME=/uOl/oracle/product/7.1.3 
ORAC L E_SID= PROD 

ORACLE_HOME=/u01/oracle/product/7.1.3 
ORACLE_SID=TEST 

These two instances have identical ORACLE_HOMEs and differing 
ORACLE SIDs. The advantages of this are: 

• both instances will use the same executables, thus saving disk 
space 

• both instances will share executable text pages in RAM, thus 
reducing RAM requirements 

The disadvantages are: 

• it is not possible to apply a patch to the TEST instance without 
also applying it to the PROD instance 

Different ORACLEJHOME, different ORACLE_SID 

ORACLE_HOME=/u01/oracle/product/7.1.3 
ORACLE_SID=DEVL 

ORACLE_HOME=/u02/oracle/product/7.0.16 
ORACLE_SID=PROD 

These two instances have differing ORACLE HOMEs and differing 
ORACLE_SIDs. The advantages of this are: 

• you can run two different versions of Oracle software on the 
machine at the same time 

The disadvantages are: 

• you must change all PATH, ORACLE_HOME and ORACLE_SlD 
parameters when switching between instances; however, this is 
not a problem if you use (c)oraenv). 

• you need enough disk space for both software distribution sets. 

• RAM usage is higher since text pages are not shared between the 
two instances 

Different ORACLE_HOME, same ORACLE_SID 

ORACLE_HOME=/uOl/oracle/product/7.1.3 
ORACLE_SID=PROD 

ORACLE_HOME=/u02/oracle/product/7.0.16 
ORACLE_SID=PROD 
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Warning: This configuration is not recommended and is 
included here only for completeness. 


• you must change all PATH, ORACLE_HOME and ORACLE_SID 
parameters when switching between instances; however, this is 
not a problem if you use (c)oraenv). 

• you need enough disk space for both software distribution sets. 

• RAM usage is higher since text pages are not shared between the 
two instances 


• it will not be possible to connect to these instances using SQL*Net 
vl 

• it will not be possible to look at process names using ps or file 
names using Is, and tell what instance they are associated with 

The TWO_TASK environment variable, described later in this section, 
can be used to determine the default SQL*Net connect string. 

The next chapter, "Oracle Server System Administration," explains how 
to set environment variables automatically using oraenv, thus ensuring 
all users access the correct database. 


ORACLE_HOME 

ORACLE_HOME is an environment variable which contains the full 
pathname of an Oracle Server system home directory. This information 
is used to find executable programs and data files. You must set the 
ORACLE_HOME variable to identify the root directory of the Oracle 
Server directory hierarchy. This home directory is used to locate Oracle 
Server system files, among them: 

• the oracle program file ($ORACLE_HOME/bin/oracle) 

• the default database files 
($ORACLE_HOME/dbs/systdb_ name. dbf, 
$ORACLE_HOME/dbs/rbsdfr_ name. dbf, 
$ORACLE_HOME/dbs/temp db_ name. dbf, 
$ORACLE_HOME/dbs/toolrf£?_ name. dbf, and 
$ORACLE_HOME/dbs/usrdb_ name. dbf) 

• the default log files ($ORACLE_HOME/dbs/logls/d.dbf and 
$ORACLE_HOME/dbs/log2s;rf.dbf) 

• the default control files ($ORACLE_HOME/dbs/cntrlls;d.ctl, 
$ORACLE_HOME/dbs/cntrl2s/rf.ctl, and 
$ORACLE_HOME/dbs/cntrl3s/d.ctl) 

• the default configuration file ($ORACLE_HOME/dbs/inits;d.ora) 
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the dictionary initialization file ($ORACLE_HOME/dbs/sql.bsq) 


Question mark (?) symbol for $ORACLE_HOME 

In Oracle Server files and programs, a question mark (?) can be used to 
represent the value of ORACLE_HOME. For example, when you add 
new files to the database using the SQL*DBA alter tablespace add 
datafile command you would enter: 

SQLDBA> alter tablespace TEMP add datafile '?/dbs/dbs2.ora' size 
2M 

where ?/dbs/dbs2.ora stands for $ORACLE_HOME/dbs/dbs2.ora. 

Note that the full path of the ORACLE_HOME, rather than the question 
mark, is stored in the database. 

Note: In UNIX, the default directory location for database files 
is the $ORACLE_HOME/dbs directory when you use the 
CREATE TABLESPACE command. If you do not give a full 
pathname for datafiles created with this command, the files will 
be placed in the $ORACLE_HOME/dbs directory. 


ORACLE_SID 

ORACLE_SID is the Oracle Server system identifier. The sid, as it is 
referred to in this manual, locates a unique SGA for an Oracle system 
and appears in the name of trace files and in program names when 
examined using the ps(l) command. The sid usually, but not always, 
identifies database files. Each Oracle Server system must have its own 
unique ORACLE_SHX 

You must assign an ORACLE S1D to your database. This value, which 
can contain up to 32 alphanumeric characters, identifies an Oracle 
Server system. There is no default value. 

Note: If your operating system has a 14-character limit on 
filename size, you must limit the sid value to four characters or 
less. 

@ symbol for $ORACLE_SID 

The @ sign is used to denote $ORACLE_SID. For example, to specify 
that a file belongs to a specific instance, you would enter: 

SQLDBA> alter tablespace tablespace_name add datafile 
'dbsfile@.ora' 

where dbsfile@.ora would expand to dbsfiles/d.ora. 
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ORACLE PATH 


This variable tells SQL*Plus, SQL*Forms, and SQL*Menu where to find 
unspecified files (including .sql, .frm, and .dmm files). 

If you specify a file to be read, and do not specify an absolute directory 
in the filename, the application first searches for a file of that name in a 
directory specified by $ORACLE_PATH, then searches the current 
directory. 

If you are creating or writing to a file, and do not specify an absolute 
directory in the filename, the application will search for a file of that 
name in a directory specified by $ORACLE_PATH. If such a file exists, 
the application will write to it. Otherwise, it will write to the current 
directory (creating a new file, if one does not already exist there). 

If ORACLE_PATH is not set, the application will always read from and 
write to the current directory. 


ORACLE_TERM 


TZ 


This variable is used to define a terminal definition resource file for the 
Installer and for SQL*DBA fullscreen mode. If not set, this variable 
defaults to the value of your TERM environment variable. 


The TZ variable is used to set the time zone you are operating in. Check 
your operating system documentation to see if your operating system 
uses this environment variable. 



Warning: The TZ variable also enables a user to put the clock 
forward or backward, to allow for daylight saving time changes, 
or different time zones in different countries. However, note 
that this adjusted time is used to time-stamp files, produce the 
output of the 'date' command, and to obtain the current 
'SYSDATE'. Changing the value of TZ will change the value of 
'SYSDATE'. See the following example for details. Note that 
the time is initially 10:39am, but becomes 9:39am after changing 
the value of TZ. 


$ cat get_sysdate.sql 

column CURRENT_DATE format A15 

select to_char(SYSDATE, 'DD-MON-YY HH24:MI # ) CURRENT_DATE 
from dual; 
exit ; 

$ echo $TZ 
GMT-1 
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$ date 

Fri Feb 11 10:39:54 GMT 1994 
$ sqlplus -s fa/fa @get_sysdate 
CURRENT_DATE 


ll-FEB-94 10:39 

$ TZ=GMT; export TZ 

$ echo $TZ 

GMT 

$ date 

Fri Feb 11 09:40:14 GMT 1994 
$ sqlplus -s fa/fa @get_sysdate 

CURRENT_DATE 


ll-FEB-94 09:40 

The consequences of any user with access to the UNIX operating system 
changing their (personal) value of TZ are grave. For example, if one 
user has TZ=GMT-1, and enters some data into the database, the rows 
will be marked as having been created at (in the previous example) at 
10:39am. 

If a second user specifies TZ=GMT, then updates some of the previous 
user's data, the rows will be marked as having been updated at 
09:40am, or before they were created. By using different values of TZ 
(GMT+24, for example), it is possible to change completely the day on 
which a transaction is recorded. 

This may have serious implications in auditing, or any use of tables 
which use date columns for ordering purposes. Ordering changes that 
predate their creation because of the different values of TZ would be 
invalid, and might lead to the wrong row being selected from a table 
(when trying to update the most recent row, for example), with serious 
implications for data integrity. 

This problem will affect any UNIX-based Oracle application that makes 
extensive use of SYSDATE. One way to get around this problem is to 
use sequence numbers to order a table, instead of date columns. 


Orade System Architecture under UNIX 1-39 














Additional Oracle Server Executables 

Certain executables play important roles throughout the installation and 
maintenance of your Oracle Server. You will encounter them repeatedly 
in the procedures described later in this guide. These executables may 
include: 

. SQL*DBA 

• Server Manager 

• oraenv (or coraenv, for C shell users) 

• SQL*Net listeners (such as orasrv and tnslsnr) 

• tkprof 

The role of each executable is described briefly below. 


SQL*DBA 


SQL*DBA is a tool that helps database administrators manage and 
control the Oracle Server. Use SQL*DBA to monitor the use and 
performance of databases on the Oracle Server, to backup and recover 
database logs and data, and execute SQL and PL/SQL statements. 



Additional Information: For more information about 
SQL*DBA, see your Oracle Server Administrator's Guide and 
Oracle Server Utilities User's Guide. 


Server Manager 

Server Manager is Oracle Corporation's graphical database 
administration tool. Server Manager has a bit-mapped graphical user 
interface (GUI), which makes it easier for you to perform database 
administration tasks. 


oraenv(coraenv) 

A command file, oraenv (coraenv for C shell users), has been supplied 
to automate the environment setup. The oraenv command prompts you 
to enter a sid (unless an ORACLE_SlD has already been set up, in which 
case it uses that), looks up its equivalent home directory in the mapping 
file /etc/oratab, and then sets ORACLE_SID and ORACLE_HOME, 
accordingly. 

pjpi Additional Information: For more information on the oraenv 
0 ~i e (or coraenv) executable, see the section "Setting the 
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Environment" in the "Oracle Server System Administration" 
chapter. 

SQL*Net Listeners 

SQL*Net products use listener programs to accept connection requests 
from SQL*Net clients. The listener executables are controlled by control 
utilities. Some may require setuid root. Listener programs for different 
SQL*Net protocols are listed earlier in this chapter, in the section 
"Additional Processes." 

Additional Information: For more information on control 

0 =, c utilities, see the TARG. 

SQL*Net listeners perform the following functions: 

• listen for connection requests from SQL*Net clients 

• receive information from clients indicating which database the 
client wishes to access 

• set up communications between the client and the database 
process 

For information on how to bring up the listener in the rc directory, refer 
to your operating system administrator's manual. 

Additional Information: For more information about listener 
p=L programs, see the networking chapters in the TARG. 

tkprof 

A profiler tool, tkprof, has been provided to help you determine if your 
SQL statements are properly tuned. Run tkprof whenever SQL 
statements take a long time to execute, and use the results to determine 
how to tune your SQL statements to improve system performance. 
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CHAPTER 



2 


Oracle System 
Administration 


1 J[ his chapter describes UNIX-specific aspects of Oracle Server 
system administration. For additional information specific to your 
platform read the chapter, "Oracle System Administration," in your 
Installation and Configuration Guide (ICG). 

The topics covered in this chapter are: 

• setting the environment 

• managing special accounts and groups 

• managing security 

• adjusting shared memory parameters 

• adjusting semaphore parameters 

• using signal handlers 

• using the ServerManager 

• using the SQL*DBA MONITOR command 

• using PL/SQL v2 demonstrations 

• using trace and alert files 

• using single-task applications 
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Setting the Environment 

Oracle Server environment variables are described in Chapter 1 and 
Appendix B of this guide. The following sections explain how to use 
these environment variables. 

Displaying and Setting Environment Variables 

To display the value of an environment variable, use the echo command. 
For example, to display the value of ORACLE SID enter the following: 

$ echo $ORACLE_SID 

To set and export the value of a variable use the following syntax, in 
which test represents the value of the variable: 

For the Bourne shell, enter the following: 

$ ORAC L E_S ID- test 
$ export ORACLE_SID 

For the C shell, enter the following: 

% setenv ORACLE_SID test 

Strategy for Setting a Common Environment 

The oraenv command file and UNIX startup files enable the DBA to set 
a common environment for all users, and make it easier for individual 
users to move between databases. 


The oraenv command file 

The oraenv command file (coraenv in the the C shell) is created during 
the install process. It contains values for Oracle environment variables, 
and has two primary functions: 

• it provides a central means of updating all user accounts with 
regard to database changes 

• it provides a simple mechanism for users to switch back and forth 
between Oracle Server databases 

Because the oraenv command file contains a single set of values for 
Oracle environment variables, each user who runs it will end up with 
the same environment. When used in this way to set a common 
environment for all users, oraenv eases the problems encountered by 
system administrators and database administrators when they change 
the physical Oracle Server system. 


Hr 
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Local bin directory 


User startup files 


Moving between databases 


For example, you may need to move a database from /usr/oracle to 
/usrl/oracle. If you did not have a common environment-setting routine 
for all users, then you would have to make specific changes to each user 
startup file to reflect this change to the database. With this approach, 
however, each user profile file calls the oraenv command file, which 
automatically reflects any changes. 

Be sure to source oraenv (coraenv) so that ORACLE_HOME and 
ORACLE_SID are set correctly, and $ORACLE_HOME/bin is placed in 
your PATH. 

System administrators should note that when the post-installation script 
root.sh is run, the Installer will attempt to put oraenv (or coraenv) into a 
local bin directory. If this directory does not exist at install time, you can 
create it afterwards (as root). Then, when you run the root.sh script, the 
oraenv or coraenv file will be copied into the root directory. Thus, a 
local bin directory separate from $ORACLE_HOME/bin must always 
exist and must be listed in the user path. 


Note that the oraenv executable uses the file /etc/oratab to find 
ORACLE_HOME when ORACLE_SID is given. (On System V, Release 
4, this file is /var/opt/oracle/oratab.) 



Additional Information: For more information about 
/etc/oratab, see your ICG. 


Placing oraenv (or coraenv) and dbhome in the local bin directory 
ensures that these files are accessible to all users. It also ensures that 
oraenv (coraenv) will continue to work even if the path is changed to 
point to a different OR ACLE_HOME. 


Model user startup files ("profile" files) are automatically created in the 
ORACLE_HOME directory upon installation. These files, .login or 
.cshrc for the C shell, and .profile for the Bourne shell, automatically set 
the variables ORACLESID, ORACLEHOME, PATH, and TERM for 
the oracle software owner. The DBA must put the oraenv or coraenv 
command line manually in the startup file of all other users. 


To switch from one database or instance to another, you enter a simple 
command calling the oraenv routine, and reply to the prompt with the 
sid of the database desired. Always give the full path of the command 
file. For example: 
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$ . /usr/lbin/oraenv 
ORACLE_SID= [default]? sid 


Setting a Common Environment 

To update all user accounts centrally, you need only make sure that each 
user startup file calls the oraenv (or coraenv) command file. Always 
give the full path of the command file. 

The following examples assume your local bin directory is called 
/usr/lbin and PROD is the name of your production database. Refer to 
your ICG to check whether your operating system uses the same naming 
convention. If not, replace /usr/lbin with the correct name for your 
operating system. Replace PROD with the sid of your database. 

If you prefer not to be prompted for the sid at startup, you can suppress 
prompting by setting ORAENV_ASK to NO. 

For a single instance on a machine: 

For the Bourne or Korn shell: Edit the user's .profile startup file, 
replacing this line, if it exists: 

. local_bin-directory / oraenv 

with these lines: 

PATH=${PATH):/usr/lbin 
ORACLE_SID=PROD 
export PATH ORACLE_SID 
ORAENV_ASK=NO 
. oraenv 
ORAENV_ASK= 

For the C shell, enter the following: Edit the user's .login startup file, 
replacing this line, if it exists: 

source local_binjiirectoryf coraenv 

with these lines: 

setenv PATH ${PATH):/usr/lbin 
setenv ORACLE_SID PROD 
set ORAENV_ASK = NO 
source /usr/lbin/coraenv 
unset ORAENV_ASK 

For multiple instances on a machine where users want to be prompted 
for the sid at startup: 

For the Bourne or Korn shell, enter the following: 

PATH=${PATH):/usr/lbin 
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ORACLE_SID=PROD 
export PATH ORACLE_SID 

SIDLIST= 'awk -F: '/ A [ A #]/ {printf "%s ", $1}' /etc/oratab' 

echo "SIDS on this machine are $SIDLIST" 

ORAENV_ASK= 

. oraenv 

For the C shell, enter the following: 

setenv PATH ${PATH}:/usr/lbin 
setenv ORACLE_SID PROD 

set sidlist = 'awk -F: '/ A [ A #]/ {printf "%s ", $1}' /etc/oratab' 

echo "SIDS on this machine are $sidlist" 

unset ORAENV_ASK 

source /usr/lbin/coraenv 

Additional Information: For more information on the default 
0 = [c local bin directory on your system, see the "Issues and 
Restrictions" chapter in your ICG. 


Oracle System Administration 


2-5 










Managing Special Accounts and Groups 

The DBA must be familiar with special accounts required by the Oracle 
Server, and must make sure these accounts belong to the appropriate 
groups. 


Special Accounts 


UNIX accounts 


This section describes user accounts you will encounter. 


oracle The oracle software owner represents the account 

that owns the Oracle Server software. This 
maintenance account for the Oracle Server requires 
DBA privileges in order to create, start up, shut 
down, and connect internal to the database. The 
oracle software owner is never the superuser. 

root The root user is a special UNIX account that has 

maximum privileges (called "superuser" 
privileges). This account is used to configure the 
UNIX kernel; configure and install networking 
software; and create user accounts and groups. 

Oracle Server accounts 

SYS This is a standard Oracle Server database account 

with DBA privileges, that is automatically created 
at install time. The SYS account owns all of the base 
tables for the data dictionary. This account is used 
only rarely by the DBA. 

SYSTEM This is also a standard Oracle Server database 

account, with DBA privileges, automatically created 
at install time. Additional tables or views can be 
created by the SYSTEM user. DBAs may log in as 
SYSTEM to monitor or maintain databases. 

f=^| Additional Information: For more information about Oracle 
loraciJ Server accounts and users, see the Oracle Server Administrator's 
Guide. 
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Special Groups 


This section describes special group accounts you can create. 
oracle group To give only a subset of UNIX users access to the 


dba group 

Oracle Server system, you can optionally add an 
oracle group to which authorized users can belong. 
The default group ID is oracle. The oracle software 
owner must be a member of the oracle group, if such 
a group exists. 

Only the oracle software owner must be a member 
of the dba group. The root user, like other users, can 
be added to the dba group, if desired. Membership 
in this group gives access to SQL*DBA "specially 
privileged" functions. If your account is not a 
member of the dba group, you are required to enter 
a password in order to CONNECT INTERNAL or 
gain access to the other administrative functions of 
SQL*DBA. The default group ID is dba. 

root group 

Only the root user should be a member of the root 


group. 

Additional Information: For more information about user 
accounts, group accounts, and security, see the "Managing 
Security" section in this chapter. 
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There are varying levels of security, and the features available to you 
will depend on your security requirements, your system resources, and 
the configuration you use. Security may include verifying users on both 
the operating system level and the database level. Users log on to the 
operating system, and enter a password associated with the permissions 
needed to run the required programs and utilities. 

Logging on to the operating system, however, does not mean they have 
the permissions and privileges needed to run the database. They must 
log on to the database separately, and enter a password associated with 
the required privileges and permissions. Within the database, there are 
differing levels of permissions. For example, the oracle software owner 
has more privileges than users who are members of the dba group. 

The question of how tight security should be depends on whether the 
access sought is local or via the network. This section discusses a 
number of security-related issues, including: 

• local access 

• groups and security 

• security for Oracle Server utilities 

• Oracle Server roles and UNIX groups 

• security for SQL*DBA commands 

• security for database files 

• network security 

• enabling ops$ logins for SQL*Net vl and v2 

• security and remote PC users 

The Oracle Server uses several features of your UNIX operating system 
to provide a secure environment for users. These UNIX features include 
file ownership, group accounts, and the ability to have a program 
change its user ID upon execution. 

Note that using the two-task architecture of the Oracle Server 
implementation further enhances security, because there is a division of 
work (and address space) between the user program and the oracle 
program. This means all database access is achieved through the 
shadow process and special authorizations on the oracle program. 

You must keep the following security considerations in mind. 











Local Access 


Security restrictions on access to the Oracle Server depend on whether 
users access the server locally or over a network. Local access is subject 
to far fewer security restrictions, because there is less likelihood of 
unauthorized user access. To gain access, enter the name and password 
assigned you. 

Additional Information: For more information on security and 
loraciJ local access, see the Orack7 Server Concepts Manual and the 
Oracle7 Server Administrator's Guide . 


Groups and Security 

One way of ensuring greater security on your Oracle database is to 
create user groups on the operating system level. Groups are controlled 
by the UNIX file /etc/group, documented in the system administrator's 
manual for your operating system. Oracle programs are divisible into 
two sets for security purposes: those executable by all (other), and those 
executable by DBAs only. Therefore, a typical approach to security 
might be as follows: 

• Before installing the Oracle Server, create a database 
administrators' group (dba) and assign the root and oracle 
software owner IDs to this group. Programs executable by dba 
only have permission 710. The SQL*DBA system-privileged 
commands are assigned automatically to the dba group upon 
installation. 

• If you want to allow a subset of UNIX users limited access to the 
Oracle Server system, you can add an oracle group to which 
authorized users can belong. Be sure to give the Oracle Server 
utilities the oracle group ID. Publicly executable programs, such 
as SQL*Plus, SQL*Forms, and so on, should be executable by this 
group. Then change the permissions on the utilities to 710. This 
will allow execute by group, but not by other. 

• Programs executable by other should receive permission 711. 

Only those programs that will not affect database security should 
be given this permission. 

Although you can assign any name to the database administrators' 
group, dba is the default group name, and the convention used in this 
guide. If you change this group name, you must relink the Oracle 
Server kernel upon installation. Furthermore, if you have multiple 
databases with the same Oracle Server home directory 
($ORACLE_HOME), they all must have the same database 
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administrators' group. These restrictions do not apply to the group 
name for ordinary users (known as the oracle group in this guide). 

Note: Even though both the oracle software owner and root 
user should belong to the dba group, the oracle software owner 
should not be a member of the root group. In fact, the root user 
should be the only member of the root group. 


Security for Oracle Server Utilities 


You should protect the Oracle Server executables from unauthorized 
use. The method you use depends on your environment and on 
whether you use any single-task utilities that may be available. Here are 
some suggestions: 

• keep all programs in the $ORACLE_HOME/bin directory and 
give ownership to the oracle software owner 

• give all user utilities (sqlplus, sqlforms, exp, imp, and so on) a 
protection of 711 so all users on the machine can access the Oracle 
Server. 

• give all DBA utilities (such as SQL*DBA) a protection of 700 to 
restrict the use of these utilities to the oracle software owner 

Note that SQL*DBA may also be a user utility. 


Oracle Server Roles and UNIX Groups 


Another way you can use UNIX to manage site security when you are 
accessing the Oracle Server locally is to map Oracle Server roles to UNIX 
groups at the operating-system level. This tightens security for local 
access. 

The format for specifying Oracle Server roles on UNIX is: 
or a_sid_role[_d I a] 


where: 


sid 


a 


role 


d 


is your system identifier 

is the name of the Oracle Server role 

(optional) indicates that this role is to be the default 

(optional) indicates that this role is granted with the 
WITH ADMIN option. You can grant this role to 
other roles only, not to other users. 
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All entries for Oracle Server roles must be made in the /etc/group file. 
The following is an example of what your /etc/group file might look 
like: 

ora_test_osoper_d:NONE:1: jim,mary, scott 
ora_test_osdba_a:NONE:3:pat 

ora_test_rolel:NONE:4:bob,jane,tom,mary,jim 
bin:NONE:5:root,bin,sys 
dba:NONE:6:root,oracle,dba 
root:NONE:7:root 

The term "ora_test_osoper_d" stands for the name of the group; the 
term "NONE" stands for the group password; the number 1 stands for 
the group ID; and the names that follow are the comma-separated login 
names of group members. The first two entries are examples of Oracle 
Server roles, using test as the sid, and OSOPER and OSDBA as Oracle 
Server role names. The OSOPER role will be the default role for the 
users assigned to it, and the OSDBA role has the WITH ADMIN option. 

To enable these roles for a given database, you must shut down your 
database, set the init.ora parameter os_roles to true, and then restart 
your database. If you want either of these roles to be able to CONNECT 
INTERNAL, you must run ORAPWD to set a password for the role. 
When you attempt to CONNECT INTERNAL, the password you enter 
at that time will indicate the privileges associated with your role. 

Note: The Oracle Server role OSDBA is distinct from the UNIX 
dba group. For more information on UNIX groups, see your 
system administration documentation. 

Additional Information: For more information on roles, see 
Orade the "Administering Oracle Databases" chapter in the Oracle 
Server Administrator's Guide. 


Security for SQL*DBA Commands 


If you don't have SQL*Plus, you can use SQL*DBA to make SQL 
queries. However, you must be very careful how you assign access to 
SQL*DBA. The following "system-privileged" commands should not be 
accessible to anyone but the oracle software owner and the dba group 
users, since they grant special operating system privileges: 


• STARTUP 

• SHUTDOWN 

• CONNECT INTERNAL 
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Additional Information: For more information on SQL*DBA 
commands, see the Oracle Server Administrator's Guide and the 
Oracle Server Utilities User's Guide. 



Warning: Bear in mind that SQL*DBA commands can cause 
serious problems if used incorrectly. Note also that non -dba 
group users can CONNECT INTERNAL if they have the 
necessary password. 


Security for Database Files 

Database files ($ORACLE_HOME/dbs/*.dbf) should be owned by the 
same user ID from which your Oracle Server system was installed. The 
default user ID, and the convention used in this guide, is the oracle 
software owner. The authorizations on these files should be permission 
0600 : read/write (rw) by owner only, with no write authorizations for 
group or other users. 

The oracle software owner should own the directories containing the 
database files. For added security, revoke read permission from group 
and other users. 

To access the protected database files, the oracle program must have its 
set user ID (setuid) bit on. To set this bit on, perform a chmod on the 
oracle program. 

For example, 

$ chmod 6751 $ORACLE_HOME/bin/oracle 

sets the authorization for the oracle program like this: 

-rwsr-s--x 1 oracle dba 443578 Mar 10 23:03 oracle 

Note: This is done for you by the Installer. 

The s in the user execute field means when the oracle program is 
executed, it will have an effective user ID of oracle , regardless of the 
actual user ID of the person invoking it. For more information, see 
chmod in your operating system documentation. 


Network Security 

There are three additional issues to consider when dealing with network 
security: 

• using passwords on the network 

• DBA privileges over the network 

• automatic (OPS$) logins 
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Using passwords on the network 

Remote users on the network can enter their passwords in clear text, or 
encrypted. When you use clear text, there is always a danger that 
passwords can be picked up by unauthorized users, resulting in a 
breach of security. SQL*Net v2 can ensure encrypted passwords. 

DBA privileges over the network 

You should also control DBA privileges over the network. You can do 
this in two ways: 

• by setting remote DBA access to denied 

• by setting a special password in orapwd for DBA privileges 

Automatic logins 

Automatic logins to the Oracle Server (operating-system authorized 
logins) are supported on UNIX over the network. Supported SQL*Net 
protocols and the names of their server processes are shown in the 
following table: 


SQL*Net Version 

Protocol 

Process 

SQL*Net vl 

SQL*Net TCP/IP 

orasrv 

SQL*Net vl 

SQL*Net TCP/TLI 

tcptlisrv 

SQL'Net v2 

All supported v2 
protocols 

tnslsnr 


Table 2-1 SQL*Net Protocols Supporting Operating-System Authorized 
Logins 

Note also that UNIX treats a dollar sign ($) as the beginning of an 
environment variable. Therefore, when you specify an operating-system 
authorized (ops$) login on the command line or in a script, first 
"escape" the $ with a backslash (\). For example, user ID scott should 
specify ops\$scott when logging in remotely. 

Automatic logins are not allowed for the root user ID, because of 
security problems that can arise. 

Automatic logins by PC, Apple Macintosh, and OS2 users are not 
secure. Anyone can edit the Oracle configuration file and change their 
user ID. For security reasons, if users of these systems are logging in 
over the network, Oracle Corporation strongly suggests you turn off the 
ops$ logins in the listener.ora file. 
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Enabling Operating-System Authorized Logins for SQL*Net vl 

Performing an operating-system authorized login with SQL*Net vl 
requires a user called daemon in your /etc/passwd file. The daemon 
user must not have an OPS$ account in any of the local databases, nor be 
in any of the DBA groups. That is, there should be no ops$daemon 
account which would allow a user from outside to intrude into your 
local database. 

By default, the ability to CONNECT INTERNAL over the network is 
disabled, for network security. To enable this feature, add dbaon to the 
command line when invoking tcpctl (or tcptlictl) or orasrv (or tcptlisrv). 

In a secured environment, in addition to disabling DBA access (with 
dbaoff), you may want to disable OPS$ login capability over the 
network. To do this, add opsoff to the command line when invoking 

tcpctl (tcptlictl) or orasrv (tcptlisrv). 

Note: The opsoff and dbaon parameters will not show up in the tcpctl 
stat (tcptlictl stat, starctl stat, or spxctl stat) display. 

Additional Information: For more information on remote 
logins for SQL*Net vl, see the UNIX chapter in the SQL*Net 
TCP/IP User's Guide. 

Although operating-system authorized logins are supported, by default 
they are not enabled. You must set the remote_os_authent initialization 
parameter to true in order to enable them, and then start up the 
database. 

In addition, the server process must be run as setuid to root so that 
OPS$ accounts will work across the network. You will not be able to 
start up the server process unless it is setuid to root. 



Enabling Operating-System Authorized Logins for SQL*Net v2 

In Oracle7, operating-system authorized and remote DBA logins are not 
controlled by SQL*Net v2, but rather by the Oracle Server. They are 
configured via parameters in the init.ora file. Although 
operating-system authorized logins are supported, by default they are 
not enabled. You must set the remote_os_authent initialization 
parameter to true in order to enable them, and then start up the 
database. 

As a result, in SQL*Net v2, tnslsnr no longer needs to run as setuid to 
root, in general. Only in the following, seldom-encountered case, does 
tnslsnr still need to be setuid to root. This case involves a vl database 
link to a vl server, when contacted by a v2 client. In this circumstance, 
the v2 listener on the intermediate node will need to be root. 
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Additional Information: For more information about remote 
|o~iJ logins for SQL*Net v2, see the configuration instructions for 
SQL*Net v2 in the TARG. 

To perform an operating-system authorized login with SQL*Net v2 
requires a user called daemon in your /etc/passwd file. The same 
restrictions apply to this user as described earlier for SQL*Net vl. 


DBA group ID keywords 

Enabling and controlling remote login, including remote privileged 
login, is accomplished in SQL*Net v2 by configuring certain keywords 
in the /etc/listener.ora file. These keywords and their functions are as 
follows: 

DBA_GROUP Use this keyword if the name will be constant for all 
ORACLESIDs serviced by the listener. 

DBA_GROUP_s/d Use this keyword for each ORACLE_SID if the 

listener services multiple ORACLEJHOMEs, and 
the group IDs are different. 


OPS_DOLLAR LOGIN_ALLOWED and 
OPSJDOLLAR LOGIN_DENIED 

Use these keywords to control remote login. 
OPS_DOLLAR_LOGIN_DENIED is the default. 

REMOTE_DBA_OPS_ALLOWED and 
REMOTE_DBA_OPS_DENIED 

Use these keywords to control remote DBA access. 
REMOTE_DBA_OPS_DENIED is the default. 

Additional Information: If the DBA group ID for the database 
to be accessed is not the default name (dba), you can specify a 
non-default name. 

Remote login and remote DBA access parameters are set to the 
individual ORACLE_SIUs of databases on the network that apply to the 
keyword function. There is also a special value that specifies all sids at 
once. For example, either of these specifications is valid: 

PARAMETER^ ALL_SIDS 
PARAMETER sidl [, sidn . . . ] 

To see which sids have which privileges, issue the lsnrctl status 
command. 
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Checking order 


The system checks these parameters in the following order: 

1. parameters that deny access 

2. parameters that permit access 

3. the default value (denied) 

The mechanism for implementing these privileges is to manipulate the 
user ID and group ID of the shadow process forked by the SQL*Net v2 
listener. For example: 

• If OPS_DOLLAR_LOGIN_DENIED is TRUE for a particular 
ORACLE_SID, or if the user ID as reported by the client-side 
operating system has no account on the database host machine, 
then the user ID and group ID will be as found in the /etc/passwd 
file under the entry for daemon. 

Refer to the discussion of daemon in the previous SQL*Net vl 
section. 

• If both OPS_DOLLAR_LOGIN_ALLOWED and 
REMOTE_DBA_OPS_ALLOWED are TRUE for a particular 
ORACLE_SID, and if the user ID as reported by the client-side 
operating system does have an account on this system, then the 
user ID and group ID will be as found in /etc/passwd for this user 
ID. 

. If OPS_DOLLAR_LOGIN_ALLOWED is TRUE for a particular 
ORACLE_SID, but REMOTE_DBA OPS_ALLOWED is FALSE, 
then, if the user ID has DBA privileges, the process will have the 
user ID and group ID of daemon. Otherwise, the process will 
have the user ID and group ID of this user. 

Note that REMOTE_DBA_OPS_ALLOWED is FALSE by 
default: a value which Oracle Corporation does not 
recommend changing. In this case, users with DBA 
privileges will not be able to make operating-system 
authorized logins over the network. They will, however, be 
able to proceed with ordinary (password-protected) network 
logins. 

Security and Remote PC Users 

The security features discussed in this section are based on operating 
system account privileges. However, users may want to access or even 
administer a database from a remote machine, such as a small personal 
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computer (PC), which has no operating system accounts. User 
validation in these cases is accomplished by means of an Oracle Server 
password file, created and managed by the orapwd utility. 

The orapwd utility is an interactive program that the DBA (or other 
privileged account) runs manually from the command line. 

Additional Information: For a discussion of the DBA and 
OPERATOR roles, see the Oracle Server Administrator's Guide. 

The orapwd utility prompts for two user IDs, DBA and OPERATOR, 
and their passwords. It stores these in a flat file named orapwd in one 
of two locations, depending on the user's choice: 

• a local directory, the $ORACLE_HOME/dbs d i rectory 

• a global directory, /etc 

Local password files reside in the $ORACLE_HOME/dbs directory of 
the database and contain the username and password information for a 
single database. If there are multiple ORACLE HOME directories on a 
machine, each will have a distinct password file. 

A global password file may contain the usernames and passwords for 
all databases on the machine. On certain System V Release 4 machines, 
the global directory is /var/opt/oracle. 

Alternatively, the password entries can be spread among the local files 
and the global files. 

Running orapwd 

This section provides an example of an orapwd run. You must run 
orapwd from the DBA account. The orapwd utility exists in 
$ORACLE_HOME/bin after you have read in the Oracle distribution. 

Note: Unless otherwise noted, you can exit the program at any 
prompt by entering a period (.) and pressing [RETURN] or 
[CTRLl-d. 

1. Invoke orapwd. 

$ orapwd 

2. Enter the ORACLE_HOME value to be associated with the new 
user. 

Enter ORACLE home [home] ("." or <Ctrl-d> to quit): 

3. Enter the ORACLE_SID to be associated with the new user. 

Enter ORACLE SID [sid] ("." or <Ctrl-d> to quit): 
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The sid in brackets is the value of the ORACLE_SID environment 
variable in the current environment. Press [RETURN] to confirm 
the given sid, or enter a different one and press [RETURN]. 

4. Select the password file in which you will place the entry. 

The program determines whether an entry for this user already 
exists. It searches first for a local file, then for a global file. If it finds 
none, it displays the following message: 

An entry for this user does not exist - create it? (yes/no) 

Answer yes to the prompt to create a new file with this new entry. 
The program then asks you whether to write the entry in a global or 
local file: 

In which ORACLE password file is this entry to be placed? 

1 ORACLE_HOME/ dbs/o rapwd 

2 /etc/orapwd 
Enter 1, 2, or "quit": 

Choosing 1 specifies a local file; choosing 2 specifies a global file. 
Enter the number of the desired file and press [RETURN]. 

5. Complete the entry for this username. 

You are then prompted for the user's password: 

Enter new password for the dba user: 

Enter the password. It must consist of 1 to 16 alphanumeric 
characters (no unprintables, such as [CTRL] d). You are then 
prompted to confirm this password, and then to do the same for the 
operator user. 

Re-enter new password for the dba user: 

Enter new password for the operator user: 

Re-enter new password for the operator user: 

You are asked whether you wish to allow remote connections as 
INTERNAL: 

Allow remote connections as internal? (yes/no) 

Answering yes enables a user to connect to the Oracle Server over a 
non-secure connection such as TCP/IP vl and v2. Answering no 
ensures that the user can only CONNECT INTERNAL over a secure 
connection such as the Pipe driver. 

You are then prompted to add a comment, if you wish: 

Do you want to add a comment? (yes/no) yes 

Enter comment (1023 chars max.): The user is the DBA 

6. Quit the program. 
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The program returns to the prompts in Step 2. At this point you can 
quit. 

Access to a database from a remote PC 

Once Oracle Server password files exist for an Oracle Server database, 
networked PC users can access this database as INTERNAL. 
Non-privileged users can connect to the database simply by invoking an 
Oracle application that uses the database. Privileged users who want to 
perform DBA functions to the database do so by entering the 
appropriate SQL*DBA command from their PC, adding the dba user 
password. For example: 

SQLDBA> connect internal /DBA_PASSWORD 

If the dbajpassword is correct, the command will succeed. 

Users who wish to connect as OPERATOR use the same command, but 
with the operator's password. 

Remote authentication 


The following three init.ora parameters control the behavior of remote 
connections through non-secure protocols. 

remote_os_authent enables or disables ops$ connections 

os_authent_prefix used by ops$ accounts 

remote_os_roles enables or disables roles through remote 

connections 

A Warning: If REMOTE_OS_AUTHENT is set to TRUE, users 

who are members of the dba group on the remote machine will 
be able to CONNECT INTERNAL without a password. Take 
caution. Note that this ability is also controlled by a prompt 
given by orapwd: 

Allow remote connections as internal? (yes/no): 


Oracle System Administration 


2-19 










Adjusting Shared Memory Parameters 

Depending on the configuration of your Oracle Server, you may need to 
increase some of the operating system parameters governing the shared 
memory feature, especially if you plan to run more than one instance on 
the same host. Setting operating system parameters requires root access. 

The Oracle Server uses the System Global Area (SGA) to allow the 
server processes to access resources that must be shared. All oracle 
processes will attach the SGA so that they can access Oracle Server 
resources. The Oracle Server uses one SGA per instance. The size of the 
SGA is determined at startup by the number of options you have 
installed and the values of certain init.ora parameters used to configure 
the number latches, database writers, and so forth. 

To determine the size of your SGA, use the SQL*DBA command SHOW 
SGA. However, the database must be up for you to use this command. 

If you cannot bring the database up, you can estimate SGA size using 
the following formula: 

• Multiply db_block_buffers by db_block_size 

• Add the result to sort_area_size 

• Add shared_pool_size 

• Add log_buffer 

Set your operating system SGA parameters twice as high as this 
estimate for optimum performance. 


Note that the SGA resides in shared memory. Be sure your operating 
system has enough shared memory available to you. Note also that 
most UNIX ports use System V-style shared memory, and you must set 
the following shared memory parameters as described. 



Warning: If you set your init.ora parameters higher than the 
shared memory your operating system can give you, your 
database will not start. 


Additional Information: The names of the shared memory 
parameters on your system may differ from the names used 
here. For more information on the terminology used by your 
particular system, see your ICG. 


The following example illustrates why you might need to adjust shared 
memory parameters. The key operating system shared memory 
parameters are as follows (parameter names may differ on your system): 


SHMMAX the maximum size in bytes of a single shared 

memory segment 
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SHMSEG 


the maximum number of shared memory segments 
that a single process can attach 


SHMALL 


the total number of shared memory segments 
available in the entire system 


Assume that you wish to start three Oracle Server instances. Each 
instance will require a certain amount of SGA. Assume Instance A 
requires a 10 Mb SGA, Instance B requires a 15 Mb SGA, and Instance 
C requires a 30 Mb SGA. The shared memory parameters are 
configured as follows: 

SHMMAX 1 Mb 


10 


SHMSEG 


40 Mb 


SHMALL 


Note: The value of SHMALL and SHMMAX is normally 
expressed in bytes. However, to make the preceding and 
following examples more comprehensible, we have stated both 
SHMMAX and SHMALL values in megabytes (Mb). 

At start-up time, Instance A will claim 10 segments of shared memory 
(10 x 1 Mb = 10 Mb). Instance B will then try to claim 15 segments but 
will fail because the maximum number of segments per process 
(SHMSEG) is only 10. In order to start Instance B, you must do one of 
two things. Either you must increase the number of segments per 
process to 15, or you must increase the maximum size of the shared 
memory segment (SHMMAX). Oracle Corporation recommends you 
increase the size of a single shared memory segment, not the maximum 
number of segments. Therefore, SHMSEG will remain at 10, while 
SHMMAX will increase to 5 Mb. This way. Instance A allocates two, 
and Instance B three, segments of the shared memory parameter 
SHMMAX. 

Finally, to have all three instances up and running at the same time, you 
will need 55 Mb of shared memory: 10 Mb for Instance A, 15 Mb for 
Instance B, and 30 Mb for Instance C. However, the total amount of 
shared memory allowed in the system is 40 Mb. To enable all three 
instances to run the shared memory parameter, you must increase the 
shared memory parameter SHMALL to at least 55 Mb. 

The final shared memory configuration would look as follows: 


SHMMAX 


5 Mb 


SHMSEG 


10 


SHMALL 


55 Mb 
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Keep in mind that the maximum size for the SGA for a single instance 
would be the smallest value of either SHMMAX * SHMSEG or 
SHMALL. So, based on the final shared memory configuration, the 
maximum SGA size on the system at any time would be 50 Mb (5 Mb * 
10 Mb = 50 Mb, which is less than the system maximum of 55 Mb). 

For optimum performance, set the SHMMAX parameter higher than the 
size of the SGA for a single instance. Set the SHMALL parameter 
higher than recommended in your ICG. This way, you will have 
sufficient memory available at the operating system level. 

You can then alter SGA size on the Oracle Server level by adjusting the 
following parameters: 

• db_block_size 

• db_block_biiffers 


• log_buffer 


• shared_pool_size 



Warning: Note that db_block_size is set by default when you 
create the database. This parameter cannot be altered once the 
database has been created. 


After you change your SGA parameters, you must close down your 
database and restart it in order for your changes to take effect. 











Adjusting Semaphore Parameters 

If you wish to use multiple databases simultaneously, depending on the 
number of oracle processes you use with each one, you may need to 
increase some of the kernel parameters governing the availability of 
semaphores. 

Processes use semaphores to coordinate access to shared resources. If a 
shared resource is locked, a process will suspend and wait for that 
resource to become available. When the resource is available, the 
process will be posted by having its semaphore incremented. 

Some UNIX-based platforms provide post-wait drivers. These 
platforms do not use as many semaphores. Check your ICG to 
determine your platform-specific needs. 


The Oracle Server normally uses one semaphore per oracle process. 
Consult your ICG to determine if this is the case for your platform. The 
number of oracle processes is determined by the processes parameter in 
the init.ora file when the Oracle Server system is started up. The 
maximum number of concurrent Oracle Server processes for all Oracle 
Server systems is determined by the imposed limit for the maximum 
number of allowed semaphore identifiers per group system-wide. 


The following example shows why you might need to adjust the 
semaphore parameters. The key operating system semaphore 
parameters are: 


SEMMNI 

SEMMSL 

SEMMNS 

SEMMNU 


maximum number of semaphore sets on the system 
maximum number of semaphores per set 
maximum number of semaphores system-wide 
maximum number of undo structures 


These parameters set the maximum number of semaphores that will be 
available for Oracle to use; therefore, you should set them high. It is 
safe to set them higher than you estimate you will need, as unused 
semaphores do not use a large amount of system resources. 

Additional Information: The names of semaphore parameters 
on your system may differ. See your operating system 
documentation for additional information on operating system 
semaphore parameters. 

Suppose you want to start two Oracle Server systems, and the first 
Oracle Server system, oracleA, will start with 21 processes. The second 
Oracle Server system, oracleB, will start with 19 processes. Suppose 
also that the semaphore parameters are configured like this: 
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SEMMNI 8 

SEMMSL 5 

SEMMNS 60 

At startup, oracleA will claim 5 of the 8 sets of semaphores allocated by 
SEMMNI. Of these, the first 4 sets will each contain 5 semaphores (the 
maximum that SEMMSL allows per set). The fifth set will contain only 
1 semaphore. This makes a total of 21 semaphores; one for each 
process. 

When oracleB starts up, however, it will attempt to claim an additional 4 
sets of semaphores (3 sets of 5 and 1 set of 4). This totals 19 semaphores: 
one for each of the 19 oracleB potential processes. 

Since only 8 sets of semaphores are allocated by SEMMNI, and oracleA 
has already claimed 5 of them, oracleB will not be able to obtain the 4 
additional sets it needs. The oracleB system will not even be able to take 
advantage of the 4 unused semaphore slots that exist in the fifth 
semaphore set owned by the oracleA system. 

You could solve this problem by simply changing the semaphore 
parameters to values like these: 

SEMMNI 10 

SEMMSL 25 

SEMMNS 40 

Now there are plenty of semaphore sets, and plenty of semaphores per 
set. Also, the total number of semaphores allowed (40) is enough to 
accommodate the 21 processes needed for oracleA plus the 19 processes 
needed for oracleB. Remember, however, that other applications 
running on UNIX may also own semaphores and semaphore sets, 
reducing the number available to the Oracle Server. 

In general, the value of SEMMSL multiplied by the value of SEMMNI 
should be much greater than SEMMNS. The value of SEMMNS should 
be great enough to provide enough semaphores for all applications 
running on the system. 

See your operating system documentation for more information. 
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Using Signal Handlers 


This section describes signals the Oracle Server uses for two-task 
communication, and explains how you can set up your own signal 
handlers. 


Signals 


The Oracle Server uses the following signals for two-task 
communications. They are installed in a user process when you connect 
to the database, and are deinstalled when you disconnect. 


SIGCONT 

SIGINT 


SIGPIPE 


SIGCLD 


SIGTERM 


SIGIO 

SIGURG 


This signal is used by the pipe two-task driver to 
send out-of-band breaks from the user process to 
the oracle process. 

This signal is used by all two-task drivers to detect 
user interrupt requests. SIGINT is not caught by 
oracle; it is caught'by the user process. 

This signal is used by the pipe driver to detect 
end-of-file on the communications channel. When 
writing to the pipe, if no reading process exists, a 
SIGPIPE signal is sent to the writing process. 
SIGPIPE is caught by both the oracle process and 
the user process. 

This signal is used by the pipe driver. SIGCLD is 
similar to SIGPIPE, but only applies to user 
processes, not oracle processes. When an oracle 
process dies, the UNIX kernel sends a SIGCLD to 
the user process (wait () is used in the signal 
handler to see if the server process has died). 
SIGCLD is not caught by oracle; it is caught by the 
user process. 

This signal is used by the pipe driver to signal 
interrupts from the user side to the oracle process. 
This occurs whenever the user presses the interrupt 
key [CTRL] c. SIGTERM is not caught by the user 
process; it is only caught by oracle. 

This signal is used by SQL*Net v2 protocol adapters 
to indicate incoming networking events. 

This signal is used by the SQL*Net vl and v2 
TCP/IP drivers to send out-of-band breaks from the 
user process to the oracle process. 
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The listed signals affect Pro*C or other precompiler applications. Users 
can install one signal handler for SIGCLD (or SIGCHLD) and SIGPIPE 
when connected to oracle. You may have multiple signal handlers for 
SIGINT as long as the osnsui routine is called to set this up. You may 
install as many signal handlers as you like for other signals. If you are 
not connected to oracle, you can have multiple signal handlers. 

If you are using the SQL*Net vl Fast or Pipe drivers, do not set a 
SIGCHLD signal handler, and do not use the wait () system call. With 
both the Fast and Pipe drivers, the oracle shadow process is a child of 
the client. 

Note: Oracle Corporation continues to provide technical 
support for vl drivers; however, if you are using the Fast 
driver, you may prefer to upgrade to a v2 protocol adapter for 
greater ease of use. 

The following example shows how you can set up your own signal 
routine and the catching routine. For SIGINT, use osnsuiO and 
osncuiO to register and delete signal-catching routines. 

/* user side interrupt set */ 

word osnsui( /*_ word *handlp, void (*astp), char * ctx f _*/) 

/* 

** osnsui: Operating System dependent Network Set User-side 
** Interrupt. Add an interrupt handling procedure astp. 

** Whenever a user interrupt(such as a A C) occurs, call astp 
** with argument ctx. Put in *handlp handle for this handler 
** so that it may be cleared with osncui. 

** Note that there may be many handlers; 

** each should be cleared using osncui. 

** An error code is returned if an error occurs. 

*/ 


/* user side interrupt clear */ 
word osncui( /*_ word handle _*/ ); 

/* 

** osncui: Operating System dependent Clear User-side Interrupt. 
** Clear the specified handler. The argument is the handle 
** obtained from osnsui. An error code is returned if an error 
** occurs. 

*/ 
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The following is a template for using osnsuiO and osncuiO in an 
application program: 

/* 

** My own user interrupt handler. 

*/ 

void sig_handler() 

{ 

} 

main(argc, argv) 
int arc; 
char **argv; 

{ 

int handle, err; 


/* set up my user interrupt handler */ 

if (err =’osnsui(&handle, sig_handler, (char *) 0)) 

{ 

/* if the return value is non-zero, an error has occurred 
Do something appropriate here. */ 

} 


/* clear my interrupt handler */ 
if (err = osncui(handle)) 

{ 

/* if the return value is non-zero, an error has occurred 
Do something appropriate here. */ 

} 
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Server Manager is Oracle Corporation's graphical database 
administration tool. Using Server Manager, you can perform database 
administration tasks with the ease of a graphical user interface (GUI). 

Server Manager is portable across platforms, and adopts the look and 
feel of the platform on which it runs. As a result, if you run Server 
Manager on a Macintosh, it will look and behave like a Macintosh 
application. If you run Server Manager on Windows, it will look and 
behave like a Windows application. 

If your environment does not support a GUI, you can use Server 
Manager in line mode. Line mode allows you to execute commands 
explicitly on a command line. Server Manager in line mode is especially 
useful when a graphical device is unavailable, or for unattended 
operations, such as running batch jobs or scripts which do not require 
user intervention. 

To use Server Manager to manage a database, you must first create 
views on the database. In addition to views, you will need privileges 
permitting you to use Server Manager. 

Use Server Manager to: 

• start up, shut down, back up, administer, and recover a database 

• perform multiple tasks, administrative and non-administrative, 
simultaneously, using Server Manager's multiple windows 

• administer multiple databases simultaneously, including remote 
databases running on any Oracle platform at any location 
worldwide 

• dynamically execute, and keep a record of, SQL statements 








The SQL*DBA MONITOR Command 

The SQL*DBA MONITOR command is an important tool for observing 



the performance of the Oracle Server on your system. SQL*DBA can 
also be used to monitor performance in a distributed environment. If 
SQL*Net is installed, you can use SQL*DBA to connect to other 
databases. 

By default, the MONITOR command can only be used by DBAs. To 
enable someone not in the dba group to use the SQL*DBA monitor, the 
administrator must grant the user permission using 

$ORACLE_HOME/rdbms/admin/utlmon.sql. 

Additional Information: For a complete discussion of 
«=. SQL*DBA, see the Oracle Server Utilities User's Guide . 

The SQL*DBA MONITOR command is available only in full screen 
mode. 

Full Screen Mode 

If you want to use the MONITOR utility, you must invoke SQL*DBA in 
full screen mode as follows: 

$ sqldba 

The full screen implementation of SQL*DBA uses the ORACLE TERM 
environment variable to determine the terminal definition resource file 
to be used. If ORACLE_TERM is not set, SQL*DBA uses the value of the 
TERM environment variable. 

To display key mappings in full screen mode, use [CTRL1 k. 

Line Mode 

If you wish to enter SQL*DBA commands in line mode from the 
SQLDBA> prompt, you must specify line mode as follows: 

$ sqldba lmode=y 

Note that the MONITOR utility is not available in line mode. 


SQL*DBA MONITOR PROCESS Command 

The MONITOR PROCESS command is a SQIADBA command that 
displays the Oracle Server PID (process ID), the system PID, system 
username, the terminal, and program (either an Oracle Server utility or 
user application) of every active process. To run MONITOR PROCESS, 
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use the menu bar and choose the PROCESS option of the MONITOR 
menu. 

The resulting process displays the following fields, as shown in Figure 
2 - 2 . 


oracle PID 

the oracle process identifier (PID) of each process, 
starting sequentially from 1 

system PID 

the UNIX operating system PID for each oracle 
utility or user application 

system user name 

terminal 

the user ID that has logged on to the database 

The terminal from which each application or oracle 
utility is running. The "?" symbol indicates that the 
process is not attached to any terminal. 

program 

The name of each oracle utility, followed by the 
originating node for the database connection. For 
user applications, the name is This is followed 

by a string inside parentheses, indicating either the 
server background process, or the communication 
driver being used. If a two-task driver is used, this 
is followed by the PID of the shadow process. 













Session Instance Tablespace Rbsegs 

—"- Output - 


LogsBackup 


Security 


Monitor 


Minimum Process ID 
Maximum Process ID 


ORACLE Process Monitor 


o 

999999 


Oracle 
Process ID 

System 
Process ID 

Latch 

Username Waited 

Terminal 

Program 


1 




PSEUDO 


2 

28581 

oracled b 

? 

oracle@simmer 

(PMON) 

3 

28582 

oracledb 

? 

oracle@simmer 

(DBWR) 

4 

28583 

oracledb 

? 

oracle@simmer 

(ARCH) 

5 

28584 

oracledb 

? 

oracle@simmer 

(LGWR) 

6 

28585 

oracledb 

? 

oracle®simmer 

(SMON) 

7 

28586 

oracledb 

? 

oracle@simmer 

(RECO) 

8 

20816 

annie 

pts/5 

sqldba@simmer 

(Pipe Two-Task) 

9 

4310 

joe 

ttyp3 

sqlplus@grumpyr 

((TCP Two-Task) 

10 

? 

? 

ttypl 

(TCP Two-Task) 

( orapid:24231 

11 

22819 

peter 

ptx/5 

sqldba@sleepy 

(Pipe Two-Task) 

12 

22061 

larry 

pts/14 

sqldba@hamlet 

(TNS interface) 





(Restart) 

(Hide) (Quit) 


Figure 2-1 Sample Display of the MONITOR PROCESS Command 

This is an example of the SQL*DBA MONITOR PROCESS output in full 
screen mode and the different types of entries you might see displayed. 
Your screen display might not contain as many entries as the previous 
figure shows. 

Enhanced MONITOR PROCESS display 

Prior to release 6.0.33, important process information on an Oracle client 
running v5 was not in the MONITOR PROCESS display. This is because 
the v5 (or v6 PC) client does not send system PID, username, or 
program information over the network. 

As of Oracle Server v7, the MONITOR PROCESS can figure out the 
program information for v5 (and v6 PC) client processes. In the 
previous figure. Row 10 represents the SQL*Net connection from a v5 
(or v6 PC) client. It correctly displays the two-task description and 
Oracle process ID. 
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Using PL/SQL v2 Demonstrations 


Loading PL/SQL 
Demonstrations 


Running PL/SQL 
Demonstrations 


The PL/SQL distribution includes a number of sample programs you 
can load, using the following information. Perform the following steps 
with the Oracle Server open and mounted. 

Note: Demonstration and message files are in the rdbms 
directory. 

1. Invoke SQL*DBA and connect to your SYSTEM user: 

$ cd $ORACLE_HOME/plsql/demo 

$ sqldba lmode=y 

SQLDBA > connect SYSTEM /password 

here, password stands for the system user password. 

2. At the SQL*DBA prompt, load the demonstrations by invoking 

exampbld.sql: 

SQLDBA > @exampbld 


This section provides instructions on running the examples and 
samples. 

The following table lists the kernel demonstrations. 


exampl .sql 

examp5.sql 

exampl 1.sql 

samplel.sql 

examp2.sql 

examp6.sq 

exampl 2.sq 

sample2.sql 

examp3.sql 

examp7.sql 

examp13.sql 

sample3.sql 

examp4.sql 

examp8.sql 

exampl 4.sql 

sample4.sql 


Table 2-2 PL/SQL v2 Kernel Demonstrations 

The following table lists the precompiler demonstrations. 


examp9.pc 


examplO.pc 


samples.pc 


sample6.pc 


Table 2-3 PL/SQL v2 Precompiler Demonstrations 


To run the kernel demonstrations, invoke SQL*Plus to connect to the 
kernel using the user/password plsqa/supersecret. Then start the 
demonstration by typing an "at" sign (@) or the word start before the 
demonstration name. For example, to start the exampl demonstration, 
enter the following: 


$ sqlplus plsqa/supersecret 
SQLPLUS > @exampl 


To run the precompiler demonstrations, enter the following: 

$ cd $ORACLE_HOME/proc/demo 
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$ make -f proc.mk examp9 


This makes the examp9.pc executable. To start the examp9 
demonstration, enter the following: 

$ examp9 



Additional Information: For more information on the 
procedural option, see the Oracle Server Concepts Manual. 
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Using Trace and Alert Files 


This section describes the trace or "dump" files that the Oracle Server 
may create. It explains how you can use the trace files to diagnose and 
resolve operating problems. 


Trace File Contents 

Trace files are only created when something exceptional happens; they 
are associated with the process for a particular instance of a database. In 
the event that the Oracle Server encounters an exceptional condition, 
such as an access violation or an attempt to divide a value by 0, the 
Oracle Server writes a trace file. Trace files are also created by detached 
processes and servers under exceptional conditions (note that with the 
Oracle Server, regular operations will be recorded on the alert file and 
not on additional trace files). These files are of little use to most Oracle 
Server users. You may, however, need to send a trace file to your Oracle 
Customer Support representative if an unusual problem should occur. 

A trace file contains: 

• a call stack trace 

• dumps of the System Global Area (SGA), Process Global Area 
(PGA), and supervisor stacks 

Trace File Names 

The form of a trace file name is processname_sid_unixpid. trc. 
where: 

processname is a three- or four-character process name that 

shows which Oracle Server process the trace file is 
from (for example, PMON, DBWR, ORA, RECO, 
and so on) 

is the Oracle system identifier 

is a decimal number, which is the process ID 

is a file name extension appended to all trace file 
names 

An example of a trace file name is lgwr_s/d_1237.trc. 

The first few lines of the trace file include the time and date when the 
trace file was created and other information about the creation process, 
including: 


sid 

nnixpid 

.trc 
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Specifying Trace File 
Directories 


Alert Files 


• process name 

• process ID 

Note: If your system does not support filenames longer than 14 
characters, the syntax of a trace file name is 
processnamejunixpid. trc. 

There are two types of trace files: 

• trace files created by Oracle Server detached processes 

• trace files created by user processes 

These trace files are created during normal operation, but do not contain 
any valuable information under normal circumstances. They should be 
removed occasionally to avoid excessive disk space usage. 

Three initialization parameters set the directories where trace files are 
sent: 

background_dump_dest This parameter specifies the directory 

where dump files created by detached 
processes and alert files are sent. 

user_dump_dest This parameter specifies the directory 

where dump files created by user processes 
are sent. 

core_dump_dest This parameter specifies the directory 

where dump files created by core dumps 
are sent. 

An alert file is associated with a database. It records internal errors, 
important things that affect the database structure, and normal 
operations such as startup, shutdown, switches of redo log files, and 
adding tablespaces. 

The file named alerts/rf.log is located in the directory specified by the 
init.ora parameter background_dump_dest, whose default is 
$ORACLE_HOME/rdbms/log. This file logs more information than the 
usual trace files, including the following unusual database occurrences: 

• instance startup and shutdown 

• messages to the operator console 

• errors that cause a trace file to be created 

• any CREATE, ALTER, or DROP operations issued on a database, 
tablespace, or rollback segment 

• init.ora parameters current to the instance 
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• background processes being spawned 

• log switches and checkpoints 

Administer this file as other trace files. Since each new entry to this file 
is appended to the file, you need to clear it occasionally if there are no 
errors, or when you have dealt with any errors that occur. 


Using Single-Task Applications 

Before using single-task applications, refer to the "Single-Task 
Architecture" discussion in the "Oracle System Architecture" chapter. 
That section explains important considerations you must evaluate before 
making the decision to use single-task applications on your platform. 

If you wish to use single-task applications, the DBA should review the 
source code to ensure data integrity. The DBA also should review the 
source code applications to ensure they pose no risk. Before you run a 
single-task application, set the program to the oracle software owner ID 
with the setuid command. 

For a sample makefile that links single-task applications, look at the 
sample makefile, called $ORACLE_HOME/proc/lib/proc.mk, in the 
Pro*C distribution directory. This example applies to C; other sample 
makefiles for other precompilers will be found in the appropriate 
subdirectories and titled accordingly. 

To link single-task Oracle product executables, go into the 
$ORACLE_HOME/prodHcf/lib directory, invoke the makefile there, and 
use singletask as the target. For example: 

$ cd $ORACLE_HOME/sqlplus/lib 
$ make -f sqlplus.mk singletask 

This command would link a sqlplus executable called sqlplusst. This 
executable is larger than the distributed sqlplus executable, because it 
has linked in the Oracle Server kernel code and no longer uses an 
interprocess communications mechanism. Note that make 
automatically adds the "st" to the name of single-task executables. 
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Backing Up and 
Recovering a Database 


F J_' his chapter explains how to back up and recover an Oracle Server 
database using standard UNIX operating system tools. 


The topics covered in this chapter are: 


• the Oracle Parallel Backup/Restore Utility 

• planning a backup strategy 

• preparing for redo log archiving 

• setting up redo log archiving 

• exporting and importing with multiple tapes 


• recovering from failure 



Additional Information: Oracle Corporation offers a tool 
called the Oracle Parallel Backup/Restore Utility (OPBRU), 
which displays far more powerful functionality than the 
operating system backup tool described in this chapter. For 
more information on the OPBRU, refer to the Oracle Parallel 
Backup/Restore Utility Administrator's Guide. 
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The Oracle Parallel Backup/Restore Utility 

On supported platforms, the Oracle Parallel Backup/Restore Utility 
provides an effective mechanism to perform high-speed, parallelized 
robust backups and restores of Oracle data files and control files. This 
high performance utility can replace operating system tools such as tar, 
cpio, dump, and dd. Such operating system tools offer basic features in 
the areas of performance, backup media information, media labeling, 
security, and most importantly, data consistency and recovery. 

The Oracle Parallel Backup/Restore Utility works in conjunction with a 
tape management product provided by a third-party software vendor. 
These third-party products offer advanced features such as media 
management, scheduling, security, and a higher degree of reliability. 

The Oracle Parallel Backup/Restore Utility interfaces with some of these 
tape management products and provides an integrated and cooperative 
solution for backing up and restoring UNIX databases ranging from a 
few megabytes to hundreds of gigabytes. Note that tape management 
products vary from platform to platform. 
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Planning a Backup Strategy 

This section discusses UNIX-related issues you must consider when 
planning your backup strategy. The procedures for implementing a 
backup are provided later in this chapter. 

Introduction 

Backup and maintenance schemes are a vital part of planning an Oracle 
Server database. The importance of proper archiving and backup 
procedures can hardly be overemphasized. Too many databases and too 
many hours of work have been lost because an archive file could not be 
found, or files were not archived, or not backed up correctly. To ensure 
that you do not lose your database, you need a copy of database files, 
plus a copy of all archive files, taken slightly before the backup to the 
current point in time. 

Backup Requirements 

Before you can institute a backup strategy, you must first consider your 
backup needs. The answers to the following list of questions will help 
you determine the backup strategy that is most effective for you. 

• How heavy is your database usage? Twenty-four hours a day, 
seven days a week? Or eight hours a day, five days a week? 

A database in use 40 hours a week can always be brought down 
and backed up offline over weekday evenings, or the weekend. 

• How large is your database? Multi-gigabyte databases take 
longer to back up. 

Very large databases may take too much time to back up offline 
even once a week. In such cases, your best strategy may be to 
back up online daily to disk, then archive the disks to tape at the 
end of each week, or every few days, depending on other 
considerations. 

• How often is data in your database being changed? 

The more often data changes, the more frequently you should 
back it up. 

• How much data can you afford to lose? 

If you cannot afford to lose any transactions, then you should 
probably operate in ARCHIVELOG mode, perform frequent 
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online backups, and use other strategies outlined in this section to 
protect your data. 

• How are database updates performed? 

Your backup strategy should include a plan to ensure maximum 
data availability if you lose a disk. For example, you may want to 
back up your disks onto different disks, or archive your redo logs 
on separate disks, or combine both strategies. To ensure the 
effectiveness of your backup strategy, you may want to run test 
database recovery scenarios before your database develops any 
problems. 

Note that archived redo logs are dependent on each other. This means if 
you lose an archived redo log, you lose all the transactions in that log as 
well as all redo logs archived afterwards. 

You must consider the above requirements before choosing database file 
locations, because the many data files required for backup and 
maintenance require significant disk space, and therefore affect the 
layout of database files. 

The files required for backup and maintenance include: 

• export and import files both to and from disk files 

• copies of database and log files to disk 

• files for archiving the database to disk 

Additional Information: For a complete discussion of backing 
up a database, see the Oracle Server Administrator's Guide. 

Where to Archive 

Backing up the database to the file system on disk is much faster than 
backing up to tape. You must consider this when setting up automatic 
log (or other) file archiving to tape. If your database has high 
throughput, you must create multiple online redo log files or the 
database will have to stop periodically and wait for the archive log files 
to be written to tape. The additional online logs act as a buffer to give 
the tape time to catch up. 
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Basic Backup Methods 



There are three basic backup methods: 

• offline, or "cold" backup 

• online, or "hot" backup 

• export 

Offline backups 

Offline backups are full datafile, online log file, and control file backups 
of the database taken while the database is shut down. These files 
should be all you need to restore the database to the current point in 
time. 

Use offline backup only if your shutdown is error-free. Take whatever 
steps may be necessary to a normal, error-free shutdown of the 
database. Next, make backup copies of the files, bring the database up, 
and back up the files you have copied to tape. Offline backups are 
performed at the operating system level, and can be much quicker than 
backing up by exporting files. Use the operating system commands 
cpio or tar to perform offline backups. 

The one disadvantage of offline backups is that the database must be 
down to perform the backup. If your database must be accessible 24 
hours a day, 7 days a week, you must use online backups. 

Online backups 

Online backups can be performed while the database is in use, so system 
activity is not interrupted while backing up. For this reason they can be 
performed more often. Online backups are the most effective strategy 
for terabyte databases, or databases which are in use 7 days a week, 24 
hours a clay. You must be in ARCHIVELOG mode to perform online 
backups effectively. 

When you perform an online backup, data continues to be written to the 
data files, while any changes you make to data files are written to redo 
log files. 

Like offline backups, you can use online backups for single datafiles as 
well as complete database recovery. Online backups take some extra 
work, since you must follow special backup procedures through 
SQL*DBA to tell the control file which log files need to be applied to 
each online backup file. If you perform online backups, you should also 
perform an offline backup periodically, at some time when it is safe to 
bring down the database. 
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Warning: Note that online backups are useless without redo 
log archiving. 


Backing up by exporting files 


Backing up raw devices 


Use the Export and Import utilities to back up tables and whole 
databases. These utilities are portable to any database on any system 
running the Oracle Server. This type of backup is usually used to move 
a database (or selected objects) to a new Oracle system, usually on 
another machine. 


The Export utility is usually not as desirable as the backup methods 
discussed above because it is much slower. To recover a database, 
import must recreate every object in your database one by one. For 
large databases (several hundred Mb) this could take a long time, 
whereas a file backup happens as fast as your tape drive can unload the 
database files. Bear in mind that the database must be in DBA mode for 
you to export. 

Note that you can use the Export utility to export only that part of the 
database that has changed since the last export. The Export utility can 
also be used to detect database corruption and eliminate database 
fragmentation. 




Additional Information: For a discussion of the different 
export methods, see the Oracle Server Utilities User's Guide. 

Additional Information: Note that the Oracle Parallel 
Backup/Restore Utility can perform online or offline backups, 
but not exports. For more information on this tool, see the 
Oracle Backup/Restore Utility Administrator's Guide. 


If you use raw devices, you should note that on UNIX-based systems, 
you must copy the file with a buffer size which is some multiple of the 
Oracle Server block size. You can find the Oracle Server block size with 
the SQL*DBA command SHOW PARAMETERS for a value for 
db_block_size. If this value is 2048, you must set the bs (block size) 
parameter to any whole multiple of 2048. Note that you can only use dd 
to back up your raw devices. 



Additional Information: For more information about online 
backups, see the section in the Oracle Server Administrator's 
Guide. 
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A Typical Backup Strategy 

Offline and online backups 

Database administrators typically perform regularly scheduled offline 
backups during convenient time periods, such as weekends. They also 
perform much more frequent online backups at shorter time intervals 
during the week. If your database is large, you may want to back up 
one tablespace per day, and perform an offline backup once every two 
weeks. 

Remember that you will be able to bring your recovered database 
current with the most recent committed transaction. It is simply a 
question of how many log files you will need to apply, and how many 
log files your database will create in a day. You may not want to have to 
apply five hundred log files to roll your database forward to the current 
transaction. 

Export 

You may want to perform a full database export at selected longer 
intervals, especially if you have unreliable hardware. Even if you do not 
expect to have to recover from an export, an export ensures that all the 
data can be read, so it provides a minimal check. However, some 
problems are not caught unless the data is actually updated or 
imported. You can export to tape, or perform multi-tape exports by 
specifying tape volume size. 

Backing up control files 

Without control files, you cannot recover your database from any 
backup. Control files should be backed up at every offline backup. 

More important, your init.ora file should specify several control files on 
different disks in case you lose one. This creates multiple identical 
control files online. 

You must have a copy of the control file with the same file structure as 
your database to recover from an online backup. For this reason, it is a 
good idea to back it up immediately following the online backup 
procedure. 

To back up the control file with the database mounted or open, use the 
command: 

SQLDBA> ALTER DATABASE BACKUP CONTROLFILE TO filename ; 

If you lose or damage one of your control files, you can replace it with 
any other online control file. When you do an offline backup, you 
should back up the control file at the same time; otherwise, when you 
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recover a database, the data files will not be synchronized with the 
control file. Alternatively, when recovering a database, you may not 
want to roll forward to the current log file. 

Distributing tablespaces on different devices 

Spreading your tablespaces out on different devices maximizes 
throughput, but it is best to keep your tablespaces to as few large files as 
possible. This makes it easier for the database to manage space in the 
files, and give you access to larger spaces. It also makes it easier to back 
up to tape, although you may have to back up the file in pieces. You can 
use dd to do this; just be sure to give beginning and ending offsets. 


3-8 


Oracle7 for UNIX 













Preparing for Redo Log Archiving 

This section describes: 

• elements of log archiving 

• requirements for archiving to tape 

• init.ora parameters used in log archiving 

• required operator assistance 

• how to plan your redo log configuration 


Elements of Log Archiving 

The redo log files in an Oracle Server database record changes made to 
database blocks when transactions are committed. These files can then 
be used to recover a damaged database by rolling forward from the 
most recently archived version of the database. 

Archiving from the redo log buffer 

As changes are made to the database, they are written both to the 
database buffer pool, and to the redo log buffer pool. Both of these exist 
in the SGA. 

Database buffers are database blocks that have been changed, whether 
or not the changes have been committed. The Oracle Server background 
process DBWR writes these buffers to the datafiles. The existence of 
rollback segments allows you to roll back data easily, and allows the 
database to support multiple concurrent read-consistent views of the 
same tables. 

Redo log buffers consist of roll-forward data and administrative 
information. These are written to the online redo log files by the Oracle 
Server background process LGWR. These buffers are formatted 
differently from database buffers. They are written in operating system 
blocks, rather than Oracle Server blocks. Also, they are written 
sequentially, one write beginning where the previous one left off. 

Archiving to the online redo log files 

The redo log buffer is written to an online redo log file whenever a 
transaction is committed, or when the redo log buffer is full. Every 
Oracle Server database requires at least two or more online redo log 
files, so that one file can be available for writing while the other is being 
archived. You can choose whether or not to archive these log files. 
Running the database in ARCHIVELOG mode archives them. Running 
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in NOARCHIVELOG mode lets you write over the log file. Each mode 
serves a purpose. 

The point where the system stops writing to one file and begins writing 
to another is called a log switch. A log switch triggers a checkpoint. At 
each checkpoint, all database buffers which have been modified are 
written to disk. You can also set checkpoints manually by using the 
initialization parameters log_checkpoint_timeout and 
log_checkpoint_interval. Log checkpoint interval forces a checkpoint 
when a predetermined number of redo log blocks has been written to 
disk. Log checkpoint timeout forces a checkpoint after a specified time 
interval. This would be useful in case you want short disk writes but 
long log files. Also, if you have multiplexed online redo logs, it 
maintains multiple duplicate copies of the file. 

The ARCHIVELOG mode 


When the database is running in ARCHIVELOG mode, the Oracle 
Server daemon ARCH archives filled online redo log files offline. These 
archived files can then be used to restore the database in case of 
software or hardware failure. 

The NOARCHIVELOG mode 

The database can run without archiving the log files. You do not want 
to have the extra overhead of archiving when you are creating the 
database, for example. You can then run the database in 
NOARCHIVELOG mode, so that the filled files are simply written over 
when required. You are still somewhat protected, at least from instance 
failure, which requires restoring only the most recent changes to the 
database. It is not advisable to run the database regularly in 
NOARCHIVELOG mode, because if a failure occurs, the changes made 
between the last complete archive of the database and those recorded in 
the active redo log file are lost. 

The decision whether to operate in ARCHIVELOG mode or 
NOARCHIVELOG mode depends on a balancing of costs and benefits. 
Weigh the cost of the additional disk space you will require against the 
cost of data loss. 


Requirements for Archiving to Tape 

If you plan to archive to tape, your system must meet the following 
requirements: 
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Hardware 

Description 

CPU 

You must dedicate one terminal session to 
the Archive Monitor process, archmon. 
Because UNIX is always multi-tasking, 
archmon can reside in a window on one 
system. 

Tape Device 

Any type of supported tape drive, either 
cartridge or 9-track, 1600 BPi, is required. 

Software 

Description 

Operating System Utilities 

Your operating system must support the 
cpio utility. 

Network Hardware and 
Software 

Some systems require TCP/IP networking 
hardware and software to permit 
communications between ARCH and 
archmon. They also require VI of 

SQL*Net TCP/IP to be installed. 


Table 3-1 Requirements for Archiving to Tape 


Refer to the charts in the "Requirements" chapter of your ICG for 
platform-specific information. 


Log Archiving init.ora Parameters 

The init.ora file is the configuration file for an Oracle Server database. 
Oracle Server reads this file whenever it starts the database. If you later 
set any new values for a parameter in this file, you must shut down the 
database and restart it for the change to take effect. For a discussion of 
the init.ora file and its parameters as they relate to UNIX, refer to the 
next chapter, "Planning a Complex Database on UNIX." 

You must specify the following init.ora parameters in order to 
implement automatic tape archiving of redo log files: 

• log_archive_dest 

• log_archive_format 

• log_archive_start 


log_archive_dest 

Default value: $ORACLE_HOME/dbs 

This parameter indicates the destination for the archiving of the redo log 
file. The syntax of this parameter is as follows: 

log_archive_dest = device [: volume M I K I B] 

where: 
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device 


Specifies the location (device file or regular file) 
where the redo log file is to be archived. 

volume Applicable only to tape archiving. This is the size 

limit of the tape volume. The tape must be able to 
hold the size of one log file, plus an overhead of 6 
kilobytes. (In other words, if the size of your 
biggest log file is 5 Mb, then the tape must be able 
to hold at least 5.006 Mb.) When this limit is 
reached, the ARCH daemon stops the log archiving 
operation and sends a message to archmon to 
prompt you to mount another tape. When the tape 
is successfully mounted, archmon reads your 
response, and then tells the ARCH daemon to 
resume log archiving. 

B, K, or M Indicates whether the volume value refers to bytes 

(B), kilobytes (Kb), or megabytes (Mb). The default 
value is bytes. 

To archive the online redo log files to the UNIX file system indicated by 
the template /backup/arch%t_%s.dbf, enter the following line in the 
init.ora file: 

log_archive_dest = /backup/arch%t_%s.dbf 

The resulting log files are /backup/ archlog_sequence.dbf. 

To archive to tape, you must specify the file size. For example, to 
archive the redo log file to the tape designated by the device file 
/dev/rmtO, to a tape 100 Mb long, enter the following line in the init.ora 
file: 

log_archive_dest = /dev/rmtO:100M 

Note: The volume size must exceed the largest redo log file 
size, plus about 6 Kb for overhead. If the volume size is too 
small, archmon will warn you that the archival process has 
stopped. Look in the trace file for the actual error. 


log_archive_format 

Default value: %t_%s.dbf 

The preceding default value indicates the name of the file created by the 
log_archive_format parameter. This parameter is applicable only if you 
are using the redo log in ARCHIVELOG mode. The default archived 
redo log filename format is ?/dbs/arch%t_%s.dbf, where t is the thread 
number and s is the log sequence number. Note that the thread number 
is always 1, unless you are using the Oracle Parallel Server, in which 
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case the thread number is the number of the server on which the log file 
resides. When defining the default filename format, use a text string and 
variables. 



For Parallel Server: If you are not using the Parallel Server 
option, set log_archive_format to _%s.dbf. 


log_archive_start 

Default value: false 

This indicates whether archiving is to be automatic or manual when the 
instance is started. This parameter is only meaningful if the database is 
running in ARCHIVELOG mode. See "Starting ARCHIVELOG Mode" 
later in this chapter. 

Additional parameters 

The following additional init.ora parameters affect the elements of log 
files, but are not required to implement log archiving to tape. These 
relate to adjustments for tuning and performance. For a thorough 
discussion on tuning refer to the chapter, "Monitoring and Tuning Your 
System," in this guide. 

• log_archive_biiffers 

• log_archive_buffer_size 

• log_buffer 

• log_checkpoint_interval 

• log_checkpoint_timeout 

• log_files 

• log_small_entry_max_size 

• log_simultaneous_copies 


Required Operator Assistance 

Database operation stops if the system cannot write to any of the copies 
of a redo log file. This happens when it has filled the active redo log file 
but for some reason cannot write to the next one. This may occur 
because all copies of the file are corrupted or because there is an instance 
failure; for example, if LGWR died. 

If the database is running in ARCHIVELOG mode, database operation 
can stop when the file cannot be written to because it is still being 
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archived. Factors that can affect this include the size and number of the 
log files, and writing speed. 

Archiving automatically to disk 

The Archive Monitor is not needed for disk archiving, so the system will 
write to the disk until it is full, or until you stop it manually. An 
operator must then archive the data on the disk and then restart log 
archiving. This can also be done with a script, such as the one in the 
"Sample Online Backup Scripts" section later in this chapter. 

When the disk is full, you must do the following: 

1. Stop the archiving process. 

2. Stop database operation 

3. Make a new, empty, offline medium available for further archiving. 

4. Resume the archiving process. 

5. Resume database operation. 

Archiving to a large disk (225 Mb or more) requires much less operator 
assistance than archiving to smaller disks. However, the time taken to 
transfer archived files from disk to tape must be considered, since it 
constitutes an additional expense of time, unlike archiving to tape 
directly. 

Archiving automatically to tape 

If you use automatic tape format archiving, the archiving process does 
not need to be manually stopped or restarted. Tape archiving includes 
an Archive Monitor program (archmon) that communicates with 
ARCH. Archived files will not be split between tapes. When a tape 
runs out of room to accommodate in its entirety the next file to be 
archived, the archiving process suspends archiving and tells archmon to 
prompt the user for a new volume. When archmon knows the tape is 
mounted, it tells the archiving process to resume archiving. 

Because of the speed and monitoring requirements of archiving to tape, 
Oracle Worldwide Support recommends that you archive directly to 
disk if possible. You may want to set up a cron job that saves the 
archives to tape daily, then delete those archives to reclaim space. 

The archive monitoring program requires a dedicated terminal or 
window session. Large tapes can hold around 100 Mb of data. A data 
cartridge can hold about 60 Mb. 

When the Oracle Server is running, archmon works with a Pipe or 
TCP/IP interface on the machine where the Oracle Server is running. 
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(Refer to your ICG for system-specific details.) The archive monitoring 
program requires a dedicated terminal session. In a multi-tasking 
system, this can be a window on the system. 

Planning your Redo Log Configuration 

The main considerations for configuring redo log files are listed in the 
following chart. Read the discussion of each consideration, and use the 
chart to record the values you plan to use. For more information, see the 
chapter "Managing the Online Redo Log," in the Oracle7 Server 
Administrator's Guide. 


Issue 

Decision 

1 . 

Whether to multiplex (yes/no) 


2. 

Total redo log space needed 


3. 

Number of redo log files 


4. 

Device or file names 


5. 

Frequency of archive 


6. 

Number of files per tape 



Table 3-2 Redo Log Plan 


1. Do you want multiplexed redo log files? 

Decide whether you want to keep multiple copies of the redo log 
files. 

2. How much total redo log space do you need? 

The minimum size for a redo log file is 50 Kb set in operating system 
blocks , not Oracle Server blocks. Figure how many redo log files you 
want, and what size. The amount of space you need for log 
archiving each day depends on the size of your database and the 
volume of its daily activity. Log archive files may be considerably 
larger than the database files. After determining this ratio, you can 
figure space requirements for the daily log files. 

In most cases, redo log files will be between 500 Kb and 10 Mb. With 
larger file sizes, we recommend you institute checkpoints more 
frequently. This ensures that large redo log files will not fill up with 
transactions without being written to the database. Initialization 
parameters are log_checkpoint_interval and 
log_checkpoint_timeout. 
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3. How many online redo log files do you want? 

Two are required for every database. There can be no more than the 
value set for log_files for each database, up to an absolute total set 
by maxlogfiles, which cannot be greater than 255. Since the system 
can fill online files on the disk faster than it can archive them offline 
to tape, you can offset this discrepancy by creating multiple online 
log files. 

4. On which devices should you place the online files? 

For data security reasons, it is best to put redo log files on different 
storage devices from those containing the database files. Each redo 
log file in a mirrored group should be on a different device from 
other files in the same group. However, since only one redo log file 
is written at a time, there is no performance advantage to spreading 
redo log files across disks. 

5. Would you rather archive large files less often, or smaller files more 
often? 

Larger files take longer to fill, and therefore (depending on the size 
of log_checkpoint_interval or log_checkpoint_timeout) require 
fewer checkpoints. Fewer checkpoints means each checkpoint takes 
longer to perform, and recovery from instance crash takes longer. 

Larger files do not need to be archived to offline storage so often. 
However, if offline archiving is to tape, it takes much longer to 
archive the file offline than to write the disk file online. Depending 
on the number of online files, the system can fill up the online files, 
and then hang while waiting to write to a redo log file that is being 
archived. 

For archiving to tape, Oracle Corporation recommends having 
more, smaller log files. 

6. How many redo log files can be archived per archive tape? 

This is a function of the length of the tape and the size of the files. 
The formula used is: 

Number of redo log files/tape = tape volume size - 5120 (size of 
log file) 

Redo log files need not all be the same size, but this consideration 
shows why it is more convenient to make them uniform. 
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Setting Up Redo Log Archiving 

This section explains how to set up automatic redo log archiving to tape, 
and provides sample online and offline backup scripts. 

Note: Redo log archiving to tape may slow your system down 
unacceptably. Oracle Corporation recommends you archive 
automatic redo logs to disk. 


Overview 

To set up redo log archiving: 

1. Install the Oracle Server 

2. Create a database, using the CREATE statement. The redo log files 
are created automatically 

3. Set the init.ora parameters log_archive_start and log_archive_dest 

4. Restart and mount the database, but do not open it 

5. Put the database in ARCHIVELOG mode 

6. Start archmon and mount the archiving device 

7. Set automatic archiving. You can now begin entering data in your 
database. 

The following sections explain these procedures in detail. 

Note: If your UNIX system supports archmon over SQL*Net 
TCP/IP for tape archiving, start orasrv prior to log archiving to 
tape. This will include any required SQL*Net driver (such as 
SQL*Net TCP/IP, on systems supporting archmon over 
TCP/IP). Decide from which terminal or window you will run 
archmon. 


Installing the Oracle Server 


Designate one terminal or window for archmon. Install the Oracle 
Server according to the installation instructions in the "Installation" 
chapter of the ICG. 



Additional Information: For detailed information on installing 
the Oracle Server, see your ICG. 
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Setting init.ora Parameters 


After installation, edit the init.ora file and set values for the redo log file 
parameters related to the preceding table. Review the section titled 
"Planning Your Redo Log Configuration," so that you can assess: 


• the destination of the archived log files (log_archive_dest). If you 
are using tape, determine the size of each tape volume. 

• the size of the redo log buffers in the SGA (log_biiffer) 

• the frequency of checkpoints (disk writes of the database files, 
specified by log_checkpoint_interval) 

• the maximum number of redo log files that can be opened during 
database runtime (log_files) 


You will also eventually set the log_archive_start parameter to true, but 
that is best done after you have created the database (see the following 
"Starting ARCHIVELOG Mode" section). 


Creating the Redo Log Files 


Two of the tasks included in creating a database are creating log files 
and specifying the absolute maximum number of log files that can be 
open for all databases during runtime. These are both done with the 
SQL statement CREATE DATABASE. 



Additional Information: See the Oracle Server SQL Language 
Reference Manual for the syntax of the CREATE DATABASE 
statement. 


Review the section "Planning Your Redo Log Configuration," to 
determine values for the parameters required for the CREATE 
DATABASE statement. The entire statement is detailed in the preceding 
references. The portion that is relevant to redo log files is: 

CREATE DATABASE ... LOGFILE filespec Ifilespec ]... 

where filespec is: 

filename [SIZE filesize [K I M]] [REUSE] 
where: 

filename specifies the full filename and pathname of each 

redo log file. The default directory is 
$ORACLE_HOME/dbs. If you want the files to 
reside in any other directory, you must specify the 
full pathname. 
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SIZE 


specifies that the next argument is the size of the 
redo log file 

filesize is an integer value for the size of the file in bytes, 

unless you specify either M or K. If you do not 
specify a value for this, the command will fail. 

K indicates filesize in kilobytes 

M indicates filesize in megabytes 

REUSE Specifies whether the file(s) are to be reused. 

The system reactions corresponding to the arguments you specify are as 
follows: 

SIZE only The system attempts to create a new file with 

filename. If filename exists, the system returns an 
error. 

REUSE only The system writes to any existing file named 

filename. If none exists, it returns an error. 

SIZE and REUSE The system searches for files named filename and 

filesize size to use for the log files. If filename exists, 
it verifies whether the size is correct and returns an 
error if not. If filename does not exist, a file of the 
specified filesize will be used. 

The LOGFILE argument is optional to the CREATE DATABASE 
statement. If you do not specify it, two redo log files are automatically 
created, using the default names, sizes, and placement. If, after an 
upgrade, the system finds files of this name and size, it writes over 
them. 


For example, assume you want five redo log files in the default 
directory, all 500 Kb in size. Your database sid is MAIN. You know the 
old log files from the previous version of the database also had the same 
size and names. However, you have already archived them, and do not 
want to preserve them. Enter the following: 


SQLDBA> CREATE DATABASE ... 

2>LOGFILE '/usr/oracle/dbs/loglMAIN.dbf SIZE 500K REUSE 
'/usr/oracle/dbs/log2MAIN.dbf' SIZE 500K REUSE 
'/usr/oracle/dbs log3MAIN.dbf' SIZE 500K REUSE 
'/usr/oracle/dbs log4MAIN.dbf' SIZE 500K REUSE 
'/usr/oracle/dbs log5MAIN.dbf' SIZE 500K REUSE 
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Starting ARCHIVELOG Mode 


The database writes to the redo log files whether it is in ARCHIVELOG 
or NOARCHIVELOG mode. When it is in NOARCHIVELOG mode 
and one redo log file has been filled, it will write to the next one 
regardless of whether that file's current data has been archived to disk. 

In ARCHIVELOG mode, it will not write over a redo log file that has not 
been archived. In addition, the archiving of a redo log can be manual or 
automatic. This is discussed in the next section. 

To put the database into ARCHIVELOG mode for all sessions, edit the 
init.ora file to set the log_archive_start parameter to true, and specify 
an archive destination for the log_archive_dest parameter. Then, enter 
the following SQL*DBA statements: 

SQLDBA> CONNECT INTERNAL 

SQLDBA> STARTUP MOUNT 

SQLDBA> ALTER DATABASE ARCHIVELOG; 

SQLDBA> ALTER DATABASE OPEN; 

Notice that you change the database mode after you mount the 
database, but before you open it. 

Refer to the STARTUP statement syntax in the SQL*DBA section of the 
Oracle Server Utilities User's Guide. 


Starting Automatic Log Archiving 

Once the database is in ARCHIVELOG mode, you have the choice of 
archiving the data automatically or manually. (Only under special 
circumstances would you want to archive manually.) To determine 
which log file you need to archive at any given point, issue the 
SQL*DBA archive log list statement. 

To start automatic archival for a particular session, enter the following 
SQL*DBA statements: 

SQLDBA> CONNECT INTERNAL 

SQLDBA> STARTUP MOUNT 

SQLDBA> ALTER DATABASE ARCHIVELOG; 

SQLDBA> ARCHIVE LOG START 'destination 
SQLDBA> ALTER DATABASE OPEN; 

The destination variable is the destination specification for the archive 
file. This is the same as the specification for log_archive_dest, as 
discussed in the "Log Archiving init.ora Parameters" section earlier in 
this document. 

For example, to start automatic archiving to the tape device associated 
with /dev/rmtO that has a tape with 95 Mb volume size, enter: 
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SQLDBA> ARCHIVE LOG START '/dev/rmtO:95M' 

Refer to the ARCHIVE LOG statement syntax in the SQL*DBA section of 
the Oracle Server Utilities User's Guide. 


Preparing the Archiving Device 

Install the tape device, then insert the tape. Make sure the tape device is 
specified for destination in the log_archive_dest parameter. 


Starting archmon 

If using the Archive Monitor program, archmon, and archiving to tape, 
you must start archmon, as well as the orasrv process, before starting 
the database. The archmon program monitors the ARCH process, 
displaying error messages, prompting you to mount a new tape as 
needed, and confirming when it is successful. You must run archmon 
either in a dedicated window, or on a dedicated terminal. An operator 
must check it from time to time for error messages. 

archmon over TCP/IP 

The archmon program is supported over either TCP/IP or Pipes, 
depending on your particular platform. 

Additional Information: For more information on the drivers 
supporting archmon, see your ICG. 

On BSD-based operating systems, the archmon program requires the 
Oracle TCP/IP adapter to work. It communicates with the archiver 
process ARCH through the orasrv process, which must also be running. 
To check the status of orasrv, enter the command tcpctl status. If you 
need to start orasrv, enter the command tcpctl start. 

To start archmon, enter the following command: 

$ archmon connectstring 

where connectstring is the Oracle TCP/IP adapter connect string. For 
example, to start archmon on a host named central with a sid of MAIN, 
enter: 

$ archmon @T:central:MAIN 

The archmon process confirms that it has connected to the archiving 
process by displaying the message "connected." 

When the tape volume is full, the ARCH process suspends operation, 
tells archmon to prompt for a new tape, waits for a user response, and 
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only resumes log archiving upon receiving the proper response. For 
example, you might see the following message displayed: 

Message from ora_arch_MAIN@central at 11:34 ... 

Please mount a tape to /dev/rmtO 
Hit <ret> when you are done => 

Response sent successfully. 

The message source from archmon is ora_arch_s/d. 

archmon over Pipes 

Before you start archiving, you must start the Archive Monitor program 
archmon and the orasrv process. 

To start archmon, enter the following command: 

$ archmon connectstring 

For example, to start archmon in order to monitor archiving for a 
database identified by the sid of MAIN, enter: 

$ archmon @P:MAIN 

The archmon process confirms that it has connected to the archiving 
process by displaying the message "connected." 

When the tape volume is full, the ARCH process suspends operation, 
tells archmon to prompt for a new tape, waits for a user response, and 
then resumes log archiving. 

Message from ora_arch_MAIN@central at 11:34 ... 

Please mount a tape to /dev/rmtO 
Hit <ret> when you are done => 

Response sent successfully. 

The message source from archmon is ora_arch_s/rf. 

Stopping archmon 

You can stop archmon either when you shut down the database, or 
when you stop log archiving. There are two ways of shutting down the 
database that will preserve the integrity of the redo log file archiving: 

• Use the SQL*DBA statement SHUTDOWN [NORMAL1 

• Use the SQL*DBA statement SHUTDOWN IMMEDIATE 

When you shut down using either of these commands, archmon signs 
off with the following message, after archiving all remaining redo log 
files: 

Message from ora_arch_MAIN@central at 11:34 ... 
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Normal, successful termination. 


Note: If you have to use SHUTDOWN ABORT to shut the 
database down, the archiving of some log files will be 
incomplete. Therefore, you will lose data necessary to restore 
the database from the archived tape. You will be able to bring 
the database up from the redo log. 


Interrupting archmon 

You can interrupt archmon, or kill and reinvoke the archmon process, 
on the same terminal or window, or on a different one. However, if you 
forget to reinvoke it, the database will hang when all redo logs are full 
until you either reinvoke archmon to archive online logs automatically, 
or archive logs manually using SQL*DBA. 


Turning Off ARCHIVELOG Mode 

You can turn off archiving when the database is down. 

If the database is up, perform a SHUTDOWN NORMAL. Once the 
database is down, you can enter the following SQL*DBA statements to 
turn off ARCHIVELOG mode: 

SQLDBA> SHUTDOWN IMMEDIATE 

SQLDBA> CONNECT INTERNAL 

SQLDBA> STARTUP MOUNT 

SQLDBA> ALTER DATABASE NOARCHIVELOG; 

SQLDBA> ALTER DATABASE OPEN 

Stopping Archiving 

To stop log archiving, enter the following SQL*DBA statement: 

SQLDBA> ARCHIVE LOG STOP 


Managing Redo Log Files 

Using the sam efilespec required for the CREATE DATABASE statement 
(refer to the section on creating redo log files), use the SQL statement 
ALTER DATABASE to add, rename, or drop redo log files. 

Adding redo log files 

To add new redo log files, enter these commands: 

SQLDBA> ALTER DATABASE database_name 
2 ADD LOGFILE file spec [Jllespec ...] 
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Then, shut down the instance and restart. 

Moving redo log files 

You can change the location of the redo log files by renaming them with 
a different filename. The procedure is as follows: 

1. Using SQL*DBA, shut down the database. 

2. From the operating system prompt, copy the redo log files to files 
with a different name. 

For example: 

$cp/uOl/ORACLE/prod/admin/ctil.dbf /u02/ORACLE/prod/admin\ 
/ctll.dbf 

3. Using SQL*DBA, perform a startup mount. 

4. Now rename the files using SQL*DBA, as follows: 

SQLDBA> ALTER DATABASE database_name 
2 RENAME FILE '/uOl/ORACLE/prod/admin/ct11.dbf' 

TO '/u02/ORACLE/prod/admin/ctll.dbf'; 

This command is not equivalent to a UNIX command, such as mv, 
because it affects only information stored internally in the database. 
Before executing this command, make a copy of the log files. 

After executing this command, start up the database to ensure that 
the rename was successful. Once you have determined that the 
rename was successful, you can delete the original log files. 

5. From the operating system prompt, remove the old files. 

For example: 

$ rm /uOl/ORACLE/prod/admin/ct11.dbf 

Dropping and resizing redo log files 

If you want to change the size of your redo log files, you must drop 
them first, and then add them with the new size. You may also want to 
drop redo log files, just to decrease their number. With the database 
mounted but not open, use the following commands: 

SQLDBA> ALTER DATABASE databasejiame 

2 DROP LOGFILE '/uOl/ORACLE/prod/admin/ctll.dbf'; 

Do not drop redo log files until you are sure they are not being currently 
written, and they have already been archived. 

Note: If at any time you have only two log files, you will not be 
able to drop one, or even open one, because Oracle Server 
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requires that you should always have two log files available. To 
resolve this requirement, add a temporary log file. 

Sample Online Backup Scripts 

The following scripts perform online and offline backups of a database. 

If you are performing an online ("hot") backup, the database must be in 
ARCHIVELOG mode, and log archiving should be turned on. The 
script to back up archived log files assumes that log_archive_dest is set 
to /uOl/oracle/admin/PROD/arch. 

If you are performing an offline ("cold") backup, it does not matter 
whether the database is in ARCHIVELOG or NOARCHIVELOG mode. 
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Script to do a cold backup of an Oracle database 

ORACLE_HOME=/u01/oracle/product/7.1.3.1.1 
ORACLE_SID=PROD 

PATH=${ORACLE_HOME}/bin:${PATH} 
export ORACLE_HOME ORACLE_SID PATH 
ORACLE_FILES='/u*/oradata/${ORACLE_SID}/*.???' 

ORACLE_RAW_DEVICES= ' /dev/rdsk/zd2s0 /dev/rdsk/zd2sl \ 
/dev/rdsk/zd2s2' 

TAPE__DEVICE_0 = /dev/rmt/tsO 
TAPE_DEVICE_1 = /dev/rmt/1 s1n 

# Shut down the database 

sqldba «EOF 
CONNECT INTERNAL 
SHUTDOWN IMMEDIATE 
EXIT 
EOF 

# Copy the filesystem files to tape #0 using 'cpio' 

echo $ORACLE_FILES I tr ' ' '\012' I cpio -ocBva > $TAPE_DEVICE_0 

# Copy the redo log files from raw devices onto the no-rewind 
device 

# for tape #1 using 'dd' 

# 

# rewind the tape 

mt -f $TAPE_DEVICE_1 rewind 

# dd the files to no-rewind device for tape #1 
for fname in $ORACLE_RAW_DEVICES 

do 

dd if=$fname of=$TAPE_DEVICE_1 bs^lOk 

done 

# rewind the tape 

mt -f $TAPE_DEVICE_1 rewind 

# Start up the database 
sqldba <<EOF 

CONNECT INTERNAL 

STARTUP 

EXIT 

EOF 
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Script to do a hot backup of an Oracle database 

ORACLE_HOME=/u01/oracle/product/7.1.3 
ORACLE_SID=PROD 

PATH=${ORACLE_HOME}/bin:${PATH} 
export 0RACLE_HOME ORACLE_SID PATH 

ORACLE_BASEl=/u02/oradata/${ORACLE_SID} 

ORACLE_BASE2=/u03/oradata/${ORACLE_SID} 

TAPE_DEVICE=/dev/rmt/1 sOn 
ft Rewind the tape 
mt -f $TAPE_DEVICE rewind 
# 

# Build a scratch file containing the files to be backed up 

# 

TMP=/tmp/back$$ 
cat > $TMP << EOF 

system $0RACLE_BASE1/system.dbf 

tools $0RACLE_BASE1/tools . dbf 

temp $0RACLE_BASE2/temp.dbf 

rbs $ORACLE_BASE2/rbs.dbf 

users $0RACLE_BASE1/users.dbf 

users $0RACLE_BASE2/users.dbf 

EOF 
# 

# For each database file: put the associated tablespace into 

# backup mode and back up the data file to the no-rewind device, 
ft Then take the tablespace out of backup mode. This works even 

# for tablespaces made up of many database files. 

# 

cat $TMP I while read TABLESPACE FILE 
do 

# put the tablespace into backup mode 
sqldba lmode=y << EOF 
CONNECT INTERNAL 

ALTER TABLESPACE $TABLESPACE BEGIN BACKUP 

EXIT 

EOF 


ft cpio the file to the no-rewind device 
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echo $FILE | cpio -ocBva > $TAPE_DEVICE 

# take the tablespace out of backup mode 
sqldba lmode=y << EOF 

CONNECT INTERNAL 

ALTER TABLESPACE $TABLESPACE END BACKUP 

EXIT 

EOF 

done ## while 

# Remove the scratch file 
rm -f $TMP 

# 

# Back up the control file 

# 

CONTROLDEST=$ORACLE_BASEl/control.bak 
sqldba lmode=y << EOF 
CONNECT INTERNAL 

ALTER DATABASE BACKUP CONTROLFILE TO '$CONTROLDEST' 

EXIT 

EOF 

# put the control file on the tape 

echo $CONTROLDEST I cpio -ocBva > $TAPE_DEVICE 

# Rewind the tape and take it off line 
mt -f $TAPE_DEVICE rewind 

mt -f $TAPE_DEVICE offline 
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Script to back up Oracle archived log files 

ORACLE_HOME=/u01/oracle/product/7.1.3 
ORACLE_SID=PROD 

PATH =${ORACLE_HOME}/bin:${PATH} 
export ORACLE_HOME ORACLE_SID PATH 
LOG_ARCHIVE_DEST = /u01/oracle/admin/PROD/arch 
TMP_ARCHIVE_DEST=/u02/oracle/admin/PROD/tmparch 
# 

# Delete old archived log files (if they exist) 

# 

rm -f $TMP_ARCHIVE_DEST/*.arc 

# Force an archive log switch 
sqldba lmode=y << EOF 
CONNECT INTERNAL 

ALTER SYSTEM SWITCH LOGFILE 

EXIT 

EOF 

# 

# Make copies of the archived redo log files in the backup 
#directory 

for FILE in $LOG_ARCHIVE_DEST/*.arc 
do 

[ -f $FILE ] I I continue 
NAME='basename $FILE' 

# copy each archived log file to the backup directory 
cp $FILE $TMP_ARCHIVE_DEST/$NAME 

# was the copy successful? 
if [ $? != 0 J ; then 

echo "error: failed to copy archive log file '$FILE 

continue 

fi 

# 

ft The source file may still be active: that is, oracle may still 

# be writing to it. If so: the copy and the original will differ. 

# Only delete the source file if it is not active 

# 

if cmp -s $FILE $TMP_ARCHIVE_DEST/$NAME 
then 

rm $FILE 
else 

echo "skipped deletion of archive log $FILE" 
fi 

done 

# 

# Copy the backed-up archived log files to tape 

# 
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Cd $TMP_ARCHIVE_DEST 
TAPE_DEVICE= /dev/ rmt/1 sO 

find . -name '*.arc' -print I cpio -ocBva > $TAPE_DEVICE 
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Exporting and Importing with Multiple Tapes 

It is not uncommon for a DBA to need to export to tape. This section 
describes how to export and import using multiple tapes. 

The Import and Export utilities can handle multiple tape files. If the 
filename entered is a tape device, you will be prompted to specify the 
volume size of each tape. When the end of each tape volume is reached, 
you will be prompted to mount a new volume and press [RETURN] 
when the tape is ready. 

You should specify volume sizes in number of bytes. If you add one of 
the letters B, K, or M (b, k, or m), the number you enter represents 
bytes, kilobytes, or megabytes, respectively. You may also specify the 
volume size by entering volsiz e=size on the command line, or by putting 
the parameter in the parfile. 

The following is an example of an import/export over multiple tapes: 

$ imp file=/dev/rmtO volsize-lOOm 

Please mount the next volume, and hit [RETURN] when you are done 

Please mount the next volume, and hit [RETURN] when you are done 

Import terminated successfully 
$ exp 

Export File: expdat.dmp > /dev/rmtO 

Volume size ([RETURN] for no restriction) >590k 

Please mount the next volume, and hit [RETURN] when you are done 

Please mount the next volume, and hit [RETURN] when you are done 

Export terminated successfully 
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Recovering from Failure 

Recovering a database is a task with two components: restoring the 
database, then recovering it. 

Restoring the database refers to the process of copying the most recent 
backup tapes onto disk. Recovering the database refers to the process of 
applying archived redo logs to the database to roll it forward to the 
instant of failure. 

You will need two terminal sessions to perform recovery: one for 
restoring backup copies of the files you wish to recover, and another for 
running the SQL*DBA recover commands. 

Single Instance Failure 

An instance fails when work executed within that instance stops, so that 
read and write transactions are no longer being processed. Possible 
causes of instance failure include loss of power, hardware failures, and 
operating system crashes. You can diagnose instance failure by 
checking if any of the detached processes have terminated, or if work in 
the instance seems to have been suspended. 

To recover from an instance failure, shut down the instance with the 
SQL*DBA SHUTDOWN command (you may need to use the 
IMMEDIATE or ABORT option). Restart the instance using the 
SQL*DBA STARTUP command as normal. Automatic recovery 
procedures will perform the following: 

• roll forward all transactions in the redo log files 

• roll back uncommitted transactions 

• release all locks on Oracle resources 

Examine the trace files generated by the detached process (see the 
chapter "Oracle System Architecture under UNIX for more information 
on these files). Try to diagnose and correct the problem to prevent the 
failure from happening again. 
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Node Failure 


Oracle Parallel Server Option 

If you are not using the Oracle Parallel Server option, skip to the section 
titled "Media Failure." 

A node fails when a server running on that node stops. A node failure 
will lead to failure of the instance to which the stopped server belonged. 


Multi-instance Failure 


Multi-instance Oracle can perform instance recovery automatically 
because the instances coordinate their recovery operations through their 
SMON processes. If one or more instances fail, the SMON process of 
another instance notices the failure and performs instance recovery for 
the failed instance(s). 

Automatic instance recovery does not include restarting the failed 
instance(s) or any applications that were running on an instance. 
Recovery rolls back uncommited changes so that no resources remain 
locked, and ensures that the committed changes are written to the 
database files. 

Any instance still running can be the first to notice a failure and perform 
a recovery for another instance. 

Occasionally an instance may fail in a way that is not recognized by 
other instances, and therefore no other instance will know to perform 
recovery on the failed instance. If this happens, the database 
administrator must identify the failure and shut down that instance with 
the SQL*DBA SHUTDOWN command (you may need to use the 
ABORT option). If you remove the instance in this way, the other 
instances will perform automatic instance recovery. You can then restart 
the failed instance using the SQL*DBA STARTUP command as normal. 

It is possible that the instance will not restart immediately if the rollback 
segments are being used for recovery in another instance. If this occurs, 
wait a few moments for recovery to complete on the other instance, then 
re-issue the STARTUP command. 
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Media Failure 


Media failure is when a non-recoverable error occurs during a read or 
write operation involving one or more database files. For example, a 
disk head-crash that destroys any files associated with a database 
constitutes a media failure. 

Manual Recovery Using Log Files 

Media failure usually damages the database files, resulting in recovery 
normally requiring the database backups and archived redo log files. 
Since these are normally kept offline, recovery cannot be carried out 
automatically. 

Additional Information: For more information on recovering a 
database, see the Oracle Server Administrator's Guide. 

Note: You will need two terminal sessions to perform the 
recovery; one for restoring backup copies of the files you wish 
to recover, and another for running the SQL*DBA RECOVER 
commands. 

When you have restored the database files, you should use the 
SQL*DBA command RECOVER TABLESPACE, as described in the 
(WHAT) chapter of the Oracle Server Administrator's Guide. 

SQLDBA> RECOVER TABLESPACE tablespacename [ , tablespacename ] 

If offline redo log files are required, SQL*DBA will identify the first file 
it needs. You then need to restore that file using operating system 
backup commands. 

Then, return to the terminal session running SQL*DBA, and enter the 
name of the log file. If another one is needed, SQL*DBA will issue 
another prompt, and you can repeat this process, copying each file as 
needed. 

To restore the entire database, use the procedures described in the Oracle 
Server Administrator's Guide. These are similar to the procedures for 
recovering database files, except that you must close the database 
during recovery, and use the RECOVER DATABASE command instead 
of RECOVER TABLESPACE. 

Media Recovery Restrictions 

Oracle Corporation only supports point-in-time recovery to a time when 
the system was running in EXCLUSIVE mode. To recover data changed 
after that, that is, when more than one instance is running in Parallel 
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mode, use manual recover as described previously. This will let you 
recover all data up to the time of a log file switch, or the last committed 
transaction. 


Performing Open Database, Offline Tablespace Recovery 

This type of recovery can be performed where an open database has 
experienced a media failure, and the database remains open while the 
undamaged data files remain online and available for use and the 
damaged data files are taken offline automatically by the Oracle Server. 

Note: The following procedure cannot be used to perform 
complete recovery on the data files of the SYSTEM tablespace. 

If the media failure damages any data files of the SYSTEM 
tablespace, the Oracle Server automatically shuts down the 
database. 

1. The starting point for this recovery operation can vary, depending 
on whether you have left the database open after media failure 
occurred. 

If the database has been shut down, restart a new instance, and 
mount and open the database. Once the database is open, take all 
tablespaces offline that contain damaged data files. 

If the database is open, with all the damaged data files of the 
database offline, take all tablespaces offline that contain damaged 
data files. The Oracle Server should indicate the damaged data files 
by the error messages it returns. 

2. Correct the hardware problem that caused the media failure. If the 
hardware problem cannot be repaired quickly, database recovery 
can proceed by restoring damaged files to an alternative storage 
device. 

3. If files are permanently damaged, restore the most recent backup 
files (taken as part of either a full or partial backup) of only those 
data files damaged by the media failure. Do not restore any data 
files not damaged by the media failure, or any online redo log files 
or control files. If the hardware problem has been repaired and the 
data files can be restored to their original location(s), do so, and skip 
the next step of this procedure. If the hardware problem persists, 
restore the data files to an alternative storage device of the database 
server, and perform the next step. 

4. If one or more damaged data files were restored to alternative 
locations in Step 3, the new location of these files must be indicated 
to the control file of the associated database. 
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5. Depending on the type of complete media recovery procedure 
desired, CONNECT INTERNAL, then follow the instructions given 
in Step a or Step b. 

a) Use SQL*DBA to start offline tablespace recovery of all damaged 
data files in one or more offline tablespaces, using the RECOVER 
TABLESPACE statement. Go to Step 6. 

b) Use SQL*DBA to recover one or more damaged data files in an 
offline tablespace with the RECOVER DATAFILE statement. 

Note: Multiple, concurrent sessions can be used to recover 
simultaneously a damaged data file in each session. If many 
data files need recovery, this method potentially can speed up 
the media recovery process. If this option is used, make sure all 
damaged data files are recovered. Each session behaves as 
outlined in Steps 6 and 7. 

6. The Oracle Server now begins the roll forward phase of media 
recovery by applying the necessary redo log files (archived and 
online) to reconstruct the restored data file(s). The Oracle Server 
continues to apply archived redo log files until all required archived 
redo log files have been applied to the restored data file(s). The 
online redo log files are then automatically applied to the restored 
data file(s) to complete media recovery, as indicated by the 
following message: 

Media recovery complete 

Note: If no archived redo log files are required for complete 
media recovery, the Oracle Server does not prompt for any. 
Instead, all necessary online redo log files are applied, and the 
preceding message is returned. 

7. The damaged tablespaces of the open database are now recovered 
up to the moment that media failure occurred. The offline 
tablespaces can be brought online using the SQL command ALTER 
TABLESPACE with the ONLINE option. 
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Parallel Datafile Recovery 

If you do not have the Oracle Parallel Server option installed, ignore this 
section. 


For Parallel Server: The SQL*DBA command RECOVER 
DATAFILE lets you recover individual database files 
simultaneously. A datafile can only be recovered by one process 
at a time, but multiple processes can simultaneously recover 
several datafiles. This decreases recovery time by allowing 
multiple processes to run in parallel, each recovering one or 
more datafiles. 

The multiple processes can be on the same node or on different nodes. 
The RECOVER DATAFILE command is most useful when the database 
files are on separate disk drives, and the disk reads limit the speed of 
recovery. 

The syntax of this command is: 

SQLDBA> RECOVER DATAFILE [ , datafile ] 

Note: Online datafiles cannot be recovered while the database 
is open. You cannot open a database until all online datafiles 
are recovered. 



Restore Database Files 

Additional Information: For more information on recovering 
loraciJ tablespaces or the entire database, see the "Media Recovery 
Procedures" section of the Oracle Server Administrator's Guide. 


SQL*DBA RECOVER 

After you have restored the database files, you need to recover the 
tablespaces. Use the SQL*DBA RECOVER TABLESPACE command: 

SQLDBA> RECOVER TABLESPACE tablename [, table name ...J 

If offline redo log files are required at this point, SQL*DBA will identify 
the first file it needs. You then need to restore that file from tape to disk. 

First, you need to identify which tape has the right files. To do this, use 
the cpio command from the other terminal session. For example, to 
inventory the contents from a tape device identified as /dev/rmtO, enter: 

$ cpio -itBc < /dev/rmtO 

where: 

-i makes the read an input (from the device named) 
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t 


specifies "table of contents" 


B specifies that the block size used with this format is 

5120 bytes 

c specifies that the tape header is in ASCII 

The preceding command will display the contents of the tape, as 
follows: 

arch_l.dbf 
arch_2.dbf 
arch_3.dbf 
arch_4.dbf 
(etc.) 

These are the redo log files, in the default filename format, for the log 
sequences 1, 2, etc. Note that the names of your offline redo log files may 
vary from this example, depending on how you have set your 
log_archive_format initialization parameter. 

Use the cpio command again to copy the needed file to disk. For 
example, if you want log file arch_30.dbf enter this command: 

$ cpio -icBv arch_30.dbf < /dev/rmtO 

Then, return to the terminal session running SQL*DBA, and enter the 
name of the log file. If another log file is needed, SQL*DBA will issue 
another prompt, and you can repeat this process, copying each file as 
needed. 


Additional Information: For more information on database 
recovery for your specific system, see your ICG. 










CHAPTER 



Planning a Complex 
Database on UNIX 


' his chapter discusses the basic concepts of planning and building a 
complex database. 

The topics covered in this chapter are: 

• defining the scope of your database 

• assessing space needs for database objects 

• mapping data into tablespaces 

• placing temporary and rollback segments 

• planning the physical layout of the database 

• using the OFA Standard configuration 

• naming and sizing files 

• a sample default init.ora file 

• a sample complex database 
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Defining the Scope of Your Database 

The first step in building a complex Oracle Server database is deciding 
what information to store in the database. The following sections 
discuss performance issues, security, and data management features in 
the Oracle Server that are useful for managing multiple applications or 
organizations in the same database. 


Group Similar Organizations or Applications 

If several organizations or applications share the same machine, you 
may increase performance by setting them up to share the same 
database. 

Each database requires an overhead of disk space, processes, shared 
memory, semaphores, and other system resources. Therefore, the 
number of users a system can support is often increased by decreasing 
the number of databases active on the system. 

The Oracle Server supports sharing data between organizations and 
applications if both entities reside in the same database, or if they use 
separate databases and SQL*Net to access a remote database. If you use 
SQL*Net to offload the application processes from the server machine, 
this leaves more system resources available for the database. On the 
other hand, network delays increase time needed to access remote data. 


Separate Different Organizations or Applications 

You can use the Oracle Server to separate physically the data of different 
organizations and applications within a single database. 

You can set hard limits on the amount of space used by an organization 
or application. The files set aside for each organization or application 
can be independently taken offline or placed online, backed up, moved, 
or rebuilt. You can customize default temporary table locations and 
default table storage definitions to fit the needs of each organization. 


Customizing by Users 

Roles, grants, synonyms, and database links allow you to customize 
data and resource access on a user-by-user basis. 
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Multi-threaded Server 


The multi-threaded server allows you to share one or more server 
processes among all user processes. In many cases, this can increase the 
number of users who can use a database without the need to increase 
the amount of memory in the system. 

Additional Information: For more information on the 
lorjciJ multi-threaded server, see the Oracle Server Administrator's Guide 
and the Oracle Server Concepts Manual. 

JFpi Additional Information: For more information on setting up 
lo~iJ the multi-threaded server, see the SQL*Net v2 protocol adapter 
chapters of the TARG and Chapter 1 of this SARG. 

Additional Information: For information on how the 
o~i e multi-threaded server relates to your platform, see your ICG. 
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Assessing Space Needs for Database Objects 

Database files hold objects such as tables, indexes, temporary tables, 
rollback segments, and the data dictionary. You must estimate the 
amount of space you will need for these files. Use the following 
guidelines to assess space needs. 

1. Estimate the size of your tables and indexes using the formulas in 
chapter 8, "Managing Schema Objects," in the Oracle Server 
Administrator's Guide. 

If you are unable to specify accurately some parameters to the 
equations given in the Oracle Server Administrator's Guide , then load 
some data into a database as a test. Round upward from the 
resulting estimates to make sure your machine has enough disk 
space. 

Remember to plan for growth in both table and index size when 
making these estimates. Remember also that the CREATE TABLE 
parameters PCTFREE and PCTUSED, and the storage clause 
parameter PCTINCREASE, will affect the database space required 
for each table. 



Additional Information: For more information about 
PCTFREE and PCTUSED, see the Oracle Server Administrator's 
Guide. For a discussion of the storage clause and the parameter 
PCTINCREASE, see the Oracle Server SQL Language Reference 
Manual. 


2. Estimate the temporary table space you need. 

The particular mix of transactions and queries typically performed 
against your database will determine the exact amount of temporary 
table space required. Refer to the Oracle Server Administrator's Guide 
to learn when temporary segments are necessary and how to 
manage them. 

For this estimate, leave space for several of your larger tables to be 
sorted simultaneously. Remember, each sort may require twice the 
space of the entire table. 

3. Estimate the necessary rollback segment space you need. 

A rollback segment is a portion of the database that records the 
actions of a transaction which should be rolled back under certain 
circumstances. 

4. Estimate the data dictionary space you need. 
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Plan for at least five megabytes of data dictionary space. The amount of 
space required depends on the number of objects in your database. The 
sample database creation scripts can be used as rough guidelines. 

Additional Information: For a discussion of the general 
loracie considerations involved in creating a database, see the Oracle 
Server Administrator's Guide. 
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Mapping Data into Tablespaces 

This section describes usage, control, and sizing of tablespaces. 

Using the SYSTEM Tablespace 

The Installer sets up the SYSTEM tablespace and other tablespaces to 
store global resources for the database. Global resources include the 
data dictionary tables and the tables used by Oracle products. The 
SYSTEM tablespace is limited to data dictionary and catalog tables and 
views. For product tables, an additional tablespace called TOOLS is 
created during installation. There is also a tablespace for temporary 
tables called TEMP and one for rollback segments called RBS. 

In order to simplify the creation and administration of a complex Oracle 
Server database, 

• use the SYSTEM tablespace for cat*.sql, dbms*.sql, or utl*.sql 
scripts under ?/rdbms/admin 

• use the TOOLS tablespaces for any object needed for an Oracle 
tool or application 

• use other tablespaces for all other database objects 

Minimizing objects in the SYSTEM tablespace 

Keep the number of objects created in the SYSTEM tablespace to a 
minimum, for the following reasons: 

• It is much easier to estimate necessary size for the SYSTEM 
tablespace if there are only a small number of tables. 

• The data dictionary allocates SYSTEM space. 

For instance, the data dictionary may need to add new rows 
representing a new table you created in another tablespace. It 
stores all the information about that new table in the SYSTEM 
tablespace, from which it allocates space to store those rows. 

If the SYSTEM tablespace has no room to insert information about 
a new table, the CREATE TABLE statement will fail, even if the 
table is created in some other tablespace. For this reason, your 
default temporary tablespace and default tablespace should also 
be changed from the default setting of the SYSTEM tablespace. 

• Various maintenance procedures are simplified when you put 
other database objects in non-SYSTEM tablespaces. 
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It is far simpler to recover a non-SYSTEM tablespace than a 
SYSTEM tablespace. (You can drop a non-SYSTEM tablespace or 
take it offline without affecting other parts of the database if you 
run in ARCHIVELOG mode, and without bringing the entire 
database down.) Being able to rebuild complex database objects 
easily simplifies recovery from media failure, resizing 
tablespaces, or tuning database file layout. 

• If you specify extents that are too small, the system will allocate 
many incremental extents. If you specify extents that are too 
large, much space is wasted. 

One safety feature is to set the initial and next extent size to the 
same value, and the percent of increase to 0. If all tables use this 
scheme and all have the same extent size, the space fragments 
created by dropping tables will be the exact size needed for 
another table. 


Placing Applications in Tablespaces 

Use the SQL statements CREATE TABLE, ALTER USER, ALTER 
TABLESPACE, and GRANT to control the space usage and security of 
applications residing in Oracle Server databases. 

• Use CREATE TABLE and ALTER USER to create tables within the 
tablespace(s) set aside for particular applications. 

• Use ALTER USER also to specify the default tablespace for a 
user's temporary tables. 

• Use ALTER TABLESPACE to specify default storage clauses in 
effect when a table is created in a particular tablespace. 

• Use GRANT to grant quotas to users on a 
tablespace-by-tablespace basis, and to grant permissions to users 
on a table-by-table basis. 


Deciding where to put applications 

You can either place applications in single tablespace or distribute them 
across several tablespaces, as a way of tuning I/O operations. The two 
basic I/O tuning methods are: 

• separate parts of the application, such as tables and their 
associated indexes 

• use disk striping to balance 1/O across multiple drives 


Planning a Complex Database on UNIX 4-7 









The physical layout of database files is discussed in the following 
section. The layout of database files on raw disk devices is discussed in 
the "Raw Devices and the OFA" section, later in this chapter. 

i=*l Additional Information: For more information on tablespaces, 
oww see the Oracle Server Administrator's Guide and the Oracle Server 
Concepts Manual. 

Avoiding fragmentation 

Fragmentation occurs in tablespaces with many tables that grow and 
then are dropped. You can minimize fragmentation by creating tables 
with sufficient space to begin with. This will preclude the later allocating 
of extents in addition to the initial extent. 

The SQL statement CREATE TABLESPACE contains a storage clause for 
defining the characteristics of storage, such as: 

• the sizes of the first extent and every subsequent extent 

• the percent by which each subsequent extent can grow 

• the maximum and minimum number of possible extents 

Additional Information: For more information on SQL 
0 =, e statements, see the Oracle Server SQL Language Reference Manual. 
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Placing Temporary and Rollback Segments 


Temporary Segments 

Place temporary segments in their own tablespace to avoid fragmenting 
other tablespaces. Set the default storage clause for that tablespace as 
follows: 

Resize the first extent so that it is at least twice as large as the init.ora 
parameter sort_area_size. 

Make all other extents the same size or larger, and set percent increase at 

0. 

The goal of resizing is to: 

• fit small operations into the sort_area_size 

• allocate intermediate operations enough space, but not too much 

• allocate large operations sufficient temporary space 

• avoid wasted space at runtime due to fragmentation 

Rollback Segments 

The constraints governing the location of rollback segments in 
tablespaces are: 

• No tablespace containing an active rollback segment may be 
taken offline. Rollback segments are global resources available to 
any transaction occurring in a database. 

• Rollback segment placement affects database performance, 
because every altered byte of user or data dictionary data has its 
pre-altered copy placed in a rollback segment. 

Oracle Corporation recommends you create a special tablespace 
designed just for rollback segments. This way, if you add more users or 
increase the size of transactions, you can easily resize the rollback 
segments without fragmenting tablespaces, simplifying recovery 
operations. 
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Planning the Physical Layout of the Database 

To ensure optimal performance, you should consider the following 
when planning your database: 

• integrity of the database 

• performance 

• startup speed 

• space needed for archiving and export files 

• simplicity of maintenance and backup 


Database Integrity 


When considering database integrity, you should keep in mind the 
following guidelines: 

• Keep your SYSTEM tablespace of a moderate size and make sure 
it is used for SYS and SYSTEM objects only. 

• Make sure your archive files are on a separate device from your 
database files. 

• Keep more than two online log files. 


Performance 

General suggestions for enhancing performance are: 

• Spread I/O across several disks and controllers when possible. 
Several small disks are faster than a single large disk. 

• Increase the size of log files for larger databases. 

• Use asynchronous I/O and the post-wait drivers on operating 
systems supporting this functionality. 

An important consideration in creating a complex database is planning 
how to distribute it over various physical devices. The files to consider 
placing are: 

data files Data files are typically large, and require most of 

the disk space used by a database. 

online redo log Online redo log files are best located on otherwise 
files quiet physical devices to improve throughput. 
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archived redo log Archived redo log files should not reside on the 
files same physical device as database or online redo log 

files. 

control files You should have multiple control files spread across 

multiple physical devices so no single media failure 
can cause extensive data loss. 

Additional Information: For more information on data files, 
control files, and redo log files, see the Oracle Server 
Administrator's Guide. 

Startup Speed 

Startup speed can be affected greatly by online log file size. The more 
transactions that have occurred since the last checkpoint, the more 
transactions will have to be reapplied to the database before startup. 

If you have increased the log file size over the installation defaults, you 
will want to set the init.ora parameter log_checkpoint_interval or 
log_checkpoint_timeout so that checkpoints occur before the log files 
fill up. You can adjust those parameters relative to the speed at which 
your system creates a new archive sequence. However, if the system is 
creating sequences too often, the parameter values probably need to be 
larger. 

Space for Archiving and Export Files 

If the archive writing process runs out of space while archiving, your 
database will hang until you remove old files, thereby increasing space. 
It is important that you have ample disk space in your archive 
destination directory. To ensure you do, you must monitor file system 
space carefully if you are archiving to disk. Be sure to use a rotary 
backup strategy and back up onto a separate device. 

Note that for a large database, the export file may be larger than your 
disk or tape drive. The work-around for this is to use the multi-volume 
option for export. See the section on exporting in the "Backing Up and 
Recovering a Database" chapter of this manual. 



Simplifying Backup and Maintenance 

It is a good idea to place all your data files according to the Optimal 
Flexible Architecture (OFA, or ORACLE_BASE) guidelines provided in 
the following section. 
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When doing online backups, back up the files a tablespace at a time so 
that you have the fewest redo logs to apply. 
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Using the OFA Standard Configuration 

Oracle Consulting Core Technologies has developed a highly efficient 
way to configure your Oracle system for UNIX. When used at a site 
demanding high performance and low maintenance, with constantly 
evolving requirements, Oracle7 for UNIX performs best if configured in 
the Optimal Flexible Architecture (OFA). When you install Oracle in the 
ORACLE_BASE configuration, as recommended in your /CG, your 
database will be configured according to the OFA. 

Most of the following material has been excerpted from a white paper 
titled The OFA Standard Oracle7 for UNIX , by Cary Millsap. For more 
information on the OFA and how to implement it at your site, contact 
Oracle Consulting Core Technologies. 


Benefits of Using the OFA 

The main purpose of the OFA is to streamline the computing 
environment, so you get more out of your software with less effort. Use 
the OFA to: 

• balance disk I/O 

The more disks you use, the faster Oracle runs. 

You must separate "hot" tablespaces from others, so place them 
on their own disk. 

• separate different things, and group similar things 

The OFA lets you use wild card patterns to select a group of 
common files. 

• provide room for growth 

Because of the way the OFA structures the database, new 
database files get added into predictable locations. 

• co-exist with other uses of the machine 

• prevent database fragmentation 

The OFA separates database objects with different fragmentation 
rates. 

Mount Point Names 

In your UNIX system, a mount point is a directory pathname that 
specifies where a disk section's file subsystem will be linked into an 
existing UNIX file system. No matter where or how your user files and 
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software are stored, you must be able to find them quickly and easily. 

For this reason alone, it is worth spending a few minutes thinking about 
how you will structure your configuration. 

The system you ultimately decide on must balance the following 
considerations: 

• It must accommodate new users, new data, new databases, and 
new hardware. 

• It must distribute I/O load across sufficient disk drives to prevent 
performance bottlenecks. 

• It must minimize hardware costs. 

• It must isolate the potential impact of drive failure across the 
smallest possible number of applications. 

Balancing these considerations against each other means balancing 
performance against cost. To the degree that you are willing to sacrifice 
fault resilience, you can minimize your hardware costs. 

In naming mount points, the standard convention used by the OFA is to 
name mount points that hold site-specific data /pm, where p is a string 
constant that does not connote the presence of any application, while m 
is a unique fixed-length key that distinguishes one mount point from 
another. 

For example, you may want to store an Oracle database file in the same 
directory as an online backup file containing data from another 
application. You should not name the mount point for this directory 
/oracle, since that would be misleading for the non-Oracle file. Nor 
should you name the mount point /backup, because that would be 
misleading for the Oracle file. 

Mount points containing files from multiple applications should be 
named /linn where nn is a number between 00 and 99. Padding 
distinguishing keys with zeroes ensures that sorts will be performed in 
the right order, that is: 







instead of 


/»01 
/u02 
/li 03 
/1(04 


/«1 

/wlO 

/Mil 

/u2 


Do not encode hardware-dependent information into your mount point 
names, since this will cause you a great deal of difficulty when you 
upgrade, or change existing hardware. 


Home Directory Names 


Place all home directories at the same level in the UNIX file system. You 
can put home directories on different mount points and still refer to the 
collection of login homes with a single pattern. 

For example, the Oracle Server software owner s home directory might 
be named /i/01/app/oracle, while the Oracle Applications software 
owner's home directory might be named /M02/app/applmgr. Thus, 
when you want to refer to all login home directories on the system, you 
can use the pattern /*/app/* to refer to both directories. 

In naming home directories, be sure to distribute across at least two disk 
drives both (a) the collection of home directories, and (b) the contents of 
an individual home directory. 

Login home directories, therefore, should be named 
/mountpoint/home/username. Use this naming convention to manipulate 
all login home directories as a unit, even if they are distributed across 
mount points. You can also store together a set of files that should live 
in one home directory, even when the set is too big to reside in a single 
disk slice. 


Hard-Coded Path Names and Group Memberships 


Refer to hard-coded path names and group memberships only in files 
designed specifically to store them. 

Files such as /etc/passwd and /etc/group are designed to store specific 
information. Since C shell and Korn shell users can derive a user s 
home directory name easily, simply store specific information, such as 
group membership, in these files, and use -username to derive the 
user's home directory. If you are using Bourne shell instead, you can 
write a simple program to calculate a user's home directory name. In 
any event, be sure to satisfy the following requirements: 
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• Enable manipulation of files owned by any user or group of users 
with a single pattern. 

• Enable addition or manipulation of login home directories 
without having to revise programs referring to them. 

When setting up an Oracle database user .profile: 

• Assign a UNIX path value so that the user's shell can execute 
Oracle programs to set up the environment. 

• Define a sid for planned database connections. 

• Execute the program that sets the UNIX path for running Oracle 
software. 

Thus, when you have to relocate user files, the user's programs will not 
stop working. For example, you would enter the following commands 
when setting up a user's profile in compliance with the OFA: 

#set UNIX path 

PATH=/bin:/usr/bin:/usr/local/bin 

#set default instance 
ORACLE_SID= s ab 

#set ORACLE_SID / ORACLE_HOME, and PATH without asking 
ORAENV_ASK=NO ; . oraenv ; ORAENV_ASK= 

You can use the .profile to assign terminal settings, additional software 
directories in the UNIX path, ORACLE_PATH and other environment 
variables, or to connect to any instance. 

Independent UNIX Directory Subtrees 

Separate file categories into independent UNIX directory subtrees. 

Never place control files, redo log files, or data files in a subtree of the 
directory holding Oracle software. This could cause various problems, 
including an I/O bottleneck on the server when all database files are on 
a single disk, or time-consuming and difficult upgrades because all data 
will have to be carefully moved before you can begin upgrading. 

Categorize Oracle files as follows: 

product files Oracle Server software and tools supplied on Oracle 

Corporation's distribution media. 

administrative files containing data about a database or instance, 
such as archived redo log files, server process 
diagnostic output, database creation scripts, online 
exports, instance parameter files, and so forth 
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local software 


software used with Oracle that is written on site, or 
purchased separately from Oracle software 

database files control files, redo log files, and data files 

This classification ensures that files are grouped according to similar 
lifespan, maintenance schedules, and security privileges. Place each 
type of file in a subtree independent of the other types. 

Multiple Versions 

Store different versions of Oracle Server software using a naming 
convention that allows you to execute multiple versions in parallel. 

The first time you acquire and install Oracle, you should plan your 
system so that future upgrades, testing new software or tools, and 
installing new versions can be carried out without affecting daily 
operations. 

The best way to ensure flexibility in your system and compliance with 
the preceding rule is to store each version of Oracle Server software in a 
directory named base/product/version, where base stands for the login 
home directory of the Oracle software owner, and version represents the 
version of the software. 

For example, version could refer to release 6.0.36.1, 7.0.13, or 7.1.3. Most 
Oracle Server patches involve changes only to the fourth decimal place, 
such as changes from release 6.0.36.1 to 6.0.36.2. 

Thus, if you used this naming convention, an upgrade at your site 
would: 

• create a new version directory under /product 

• install the new Oracle Server release in that directory 

• create a test database so you can confirm your new software 

. once confirmed, update the home directory in the oratab file for 
the row associated with the production instance 

Once these tasks are completed, all database users must exit and re-enter 
UNIX to bring the database up again. If the upgrade is successful, you 
can now remove the old release and reclaim the space it occupied. The 
less custom material stored in the old release directory, the safer it will 
be to remove. 

The preceding process helps you understand why you should not keep 
files in the software release directory unless their lifespan is the same as, 
or shorter than, the software release. 
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Separate Administration Information About Different Databases 

Structure organization and storage of administrative data so that 
information about any database is kept separate from information about 
any other database. 

You can achieve this by storing database administration files as 
base/admin/dbname, where base represents the Oracle software owner's 
login home directory, and dbname represents the name of each database. 

Proper organization and storage of data about databases is very 
important. The type of data in this category includes programs that 
create databases, Oracle Server trace files, structural records, instance 
parameters, performance statistics, backups, archives, and general 
logbook entries on each database. The more databases on your system, 
the greater the volume of data you must administer. 

Store Oracle Database Files Separately From All Other Files 

Oracle database files should be stored separately from all other files, 
using the following patterns: 

control files /mountpoint/oradata/dbname/ control.ctl 

redo log files Imountpointloradata/dbname/redonAog 

data files lmountpoint/oradata/dbname//tablespacenn.d bf 

where oradata denotes the separation of Oracle data from all other files, 
dbname is the name of the database, nn is a distinguishing key that is 
fixed-length for a given file type, and tablespace is an Oracle tablespace 
name. 

Most people choose to call the directory holding Oracle data oracle, or 
oradata. You can name the directory anything you want, and store it 
anywhere, as long as you satisfy the following requirements: 

• The name you choose must be consistent with the names of other, 
similar directories, and must not misrepresent the directory 
contents. 

• The level at which you store the I/O balanced files must be the 
same on every mount point. 

You should keep your Oracle database files separate from all other files 
because the lifespan of database files differs from that of all other files 
on your system. Database files also require a different backup strategy 
from other files on your system. 
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The preceding naming system eliminates confusion about the database 
associated with any file, since the name of the database becomes a 
component of the file's fully qualified pathname. 

Oracle database files should be stored so that you meet the following 
requirements: 

• Oracle database files are easily distinguishable from other files. 

• Files of any database are easily distinguishable from files of any 
other database. 

• Control files, redo log files, and data files are easily 
distinguishable from each other. 

• The association of data file and tablespace is easily identifiable. 

Note that it is a good idea to build a /oradata/dbname structure for every 
database and every mount point, even if you do not intend to put 
database files on every mount point. In an emergency, any such free 
disk space on your system can be used to house a file from any database 
that could require more space. 

Tablespaces and the OFA 

Store groups of segments with differing lifespans, I/O request demands, 
and backup frequencies on different tablespaces. In addition to the 
applications segment tablespaces, the following special tablespaces are 
created automatically for each Oracle database: 


SYSTEM 

data dictionary segments only 

TEMP 

temporary segments only 

RBS 

rollback segments only 

TOOLS 

general-purpose tools only 

USERS 

miscellaneous user segments 


There are several reasons to configure your system this way. For 
example, using this configuration, you would store data dictionary 
segments only in the SYSTEM tablespace. Data dictionary segments are 
never dropped, and since no other segment that can be dropped is 
allowed in the SYSTEM tablespace, SYSTEM will never need to be 
rebuilt because of tablespace free space fragmentation. Again, using the 
above configuration, you would never store a rollback segment in any 
tablespace holding applications data. This means the database 
administrator can take applications data tablespaces offline for 
maintenance anytime without affecting the work of users. 
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Keep the following requirements and restrictions in mind when setting 
up tablespaces: 

• Dropping segments causes free space fragmentation that can 
lower application performance. Conversely, separating segments 
with different lifespans into different tablespaces may increase 
application performance. 

• The DBA can only determine what set of operating system files a 
segment will occupy at the tablespace level. Separating segments 
into different tablespaces facilitates I/O load balancing. 

• The DBA can only specify segments for backup or restrict space 
usage at the tablespace level. Separating segments into different 
tablespaces gives the dba greater administrative control over 
collections of segments. 

Using the OFA conventions separates tablespace contents in such a way 
as to minimize tablespace free space fragmentation and I/O request 
contention, and maximize administrative flexibility. 


Tablespace Names 

Name tablespaces connotatively with 8 characters or fewer. For 
example, a mail database may be named "MAIL". For an Oracle 
Financials database, you may want to name the index "FININDEX" and 
the database itself "FINDATA". 

The OFA standard naming convention requires you embed the name of 
a tablespace in the basename of its associated data files. Given UNIX 
filename length restrictions on some systems, this means you may have 
no more than eight characters to accommodate each tablespace name. 

Also, resist the temptation to embed the word "tablespace," or 
abbreviations thereof, in your tablespace names. A name like 
TEMP_TABLESPACE is unnecessary. 


Raw Devices and the OFA 

If using raw devices, choose a small set of standard sizes for all raw 
devices used to store Oracle database files. 

"Raw device" is another term for a character special file, or an 
unmounted disk slice Oracle can read and write to without incurring 
overhead such as UNIX I/O buffering. While the use of raw devices can 
increase performance in some cases, it is not without its costs. Before 
you make the decision to use raw devices, read this section and the 
section on "Tuning Raw Devices," in this guide. 
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Disadvantages 

Raw devices have the following disadvantages: 

• Raw devices cost more to administer. Backup and recovery, I/O 
load balancing, and adding files to your database can become 
much more difficult when you use raw devices. If you cannot 
carefully practice database recovery before implementing your 
database, do not use raw devices. If you do not have enough disk 
volume to leave two or more large unformatted disk slices 
available for unanticipated growth or I/O balancing, do not use 
raw devices. 

• Raw devices are useful only in cases of I/O bottleneck which you 
cannot alleviate by tuning SQL statements or balancing remaining 

I/O across your disks. Raw devices can actually reduce 
random-access read performance. 

• If your UNIX system does not include variable disk partitioning, 
raw devices can require more disk volume than buffered 1/O 
configurations. If you have only a small number of large raw disk 
slices, you may be tempted to combine database segments that 
should be separated among Oracle tablespaces, with dangerous 
consequences. Variable disk partitioning allows you to use raw 
devices for redo log files because raw devices afford you the most 
benefit when used for write-intensive, sequentially accessed data, 
and online redo log files are not included in normal operating 
system backup procedures. 

Advantages 

Raw devices provide the following advantages: 

• If you plan to use Oracle Parallel Server in a UNIX cluster, with 
multiple UNIX nodes manipulating a single database on a shared 
disk subsystem, you must use raw devices. UNIX vendors have 
not yet implemented a way for nodes in a cluster to shared a 
mounted file system. 

• Some platforms allow you to use asynchronous I/O to boost 
output performance. Asynchronous I/O may only be available 
with raw devices. Contact Oracle Core Consulting or your 
operating system vendor for more details. 

• Using raw devices can increase throughput if you can meet all the 
following conditions: 

- Your application SQL statements are carefully constructed to 
minimize I/O. 
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- Your I/O load is balanced across enough disks that each 
drive's data transfer rate is within the manufacturer's 
recommended limits for the drive and the controller. 

- Either your processes frequently wait for I/O; or 

- Your system state CPU time is persistently excessive. 


Guidelines 

If, after weighing all the costs and benefits, you decide to use raw 
devices, be sure that you spread disk I/O load across all drives, 
including drives storing Oracle data in raw devices. 

Remember, two raw devices can trade places on a disk only if they are 
precisely the same size. Therefore, when you create raw disk slices, be 
sure they are a standard size. This will make it easier for you to remedy 
any persistent I/O imbalance. 

Finally, remember that use of raw devices does not necessarily increase a 
site's throughput. If you are not running Oracle Parallel Server, and 
testing shows no performance improvement from the use of raw devices 
in your specific environment, then using them would be more cost than 
gain for you. 

If testing shows improved performance that outweighs the cost of 
administering raw devices, then you will probably want to use them. 
However, note that if you do not have the time or expertise to invest in 
construction of a test to determine whether or not to use raw devices, 
then you probably do not have the time or expertise to administer raw 
devices effectively. 

You may wish to use raw devices for some database files only. For 
example, you might create a hybrid system with unbuffered I/O for 
sequential write-intensive files (such as redo log files), and buffered I/O 
for other files (such as control and data files that have to be backed up 
by a UNIX administrator). Depending on your familiarity and expertise 
in setting up such a configuration, this could result in the optimum 
balance of low cost and high gain. 
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For Parallel Server: If using Oracle Parallel Server, select 
exactly one node N to act as Oracle administrative home for the 
cluster to house the administrative subtree h/admin/d. Let h 
stand for the Oracle software owner's login home directory on 
node N. Create a directory named for each instance accessing 
database d within the bdump, cdump, logbook, pfile, and 
udump directories of N:h/admin/d. On every node n in the 
cluster, except N, mount the remote directory N:h/admin/d as the 
administrative directory for database d. 

For Parallel Server: Using Oracle Parallel Server (OPS) brings 
its own set of challenges to the database administrator. To 
structure the Oracle Parallel Server to deliver maximum 
flexibility and performance, you must meet the following 
requirements: 


- Database-specific administrative data must be stored in a 
central place accessible to all instance administrators. 

- Instance-specific administrative data must be distinguishable 
as associated with a given instance by filename. 

Using the OFA configuration means you need never search multiple 
directories to find all the reports on DBAJJSERS for a given database, 
and you need never look through a list of VSPARAMETER reports to 
find the ones related to the instance you are inspecting. 

Very large databases and the OFA 

If you can afford enough hardware to (a) guarantee that each disk drive 
will only contain files from one application, and (b) dedicate enough 
drives to each database to ensure there will be no I/O bottleneck, then 
you should name your mount points / oradata/dbname/mountpoint , where 
oradata denotes that Oracle data and nothing else is stored there, dbname 
is the value of the db_name init.ora parameter for the single database 
that will be stored there, and mountpoint is a unique fixed-length key 
distinguishing one mount point for a given database from another. 

Bear in mind that each disk drive, not disk slice, should contain files 
from one application. This strategy is only economically feasible for a 
handful of very large databases around the world. 

For more information on raw devices, performance tuning, and the 
Optimal Flexible Architecture, contact the Oracle Consulting Core 
Technologies group. 
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Naming and Sizing Files 

Whenever possible, use filenames that follow the conventions of the 
Oracle Server installation. That is, the first database file is dbsls/d.dbf, 
the second dbs2s/d.dbf, and so on. Log file and control file names are 
similar: logls/rf.dbf, log2s/'d.dbf. Note that unless you use symbolic 
links you will not have as much control over filenames when you use 
raw devices. Therefore, it is important to keep a map showing which 
devices belong to which tablespaces, logfiles, and so on. If you use soft 
links to point to raw devices you can name the soft links accordingly. 
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Default init.ora File 


Sample init.ora File 


This section documents the default init.ora file provided with the Oracle 
Server distribution media. You can modify it to customize the Oracle 
Server installation at your site. 

Some init.ora parameter settings are generic to any size installation. For 
those parameter settings requiring different values for different size 
installations, three scenarios have been provided: Small, Medium, and 
Large. In the sample init.ora file shown below, parameters dependent 
on installation size are shown for each setting. Simply comment out the 
settings that do not apply to your installation. 


The following table suggests the approximate SGA size needed for the 
three scenarios provided in the init.ora file. 


Installation/Database Size 

Block Size 


Small 

Medium 

Large 

2K 

4500K 

6800K 

17000K 

4K 

5500K 

8800K 

21000K 


Table 4-1 Relative Block Sizes Required for Installation 

Note: The default name for your database is no longer default. You 
will be prompted to supply a database name during installation. The 
value you supply will be written to the init.ora file as the db_name 
parameter. 



Additional Information: For a complete list of init.ora 

parameters, see the Oracle Server Administrator's Guide. 


This sample init.ora file is provided to help you customize your Oracle 
Server installation for your site. You will find important system 
parameters discussed, and example settings given in this file. 

Use the preceding table to approximate the SGA size needed for the 
three scenarios provided in this file 

This way, when you change a public parameter, it is changed 
automatically on all instances. This is necessary, since all instances must 
run with the same value for many parameters. For example, if you 
choose to use private rollback segments, these must be specified in 
different files, but since all gc_* parameters must be the same on all 
instances, they should be in one file. 
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Additional Information: The gc_* parameters are Oracle 
Parallel Server parameters. For more information about gc_* 
parameters or the Oracle Parallel Server, see your Oracle 7 
Parallel Server Administrator's Guide. 


Edit this file, and any init files it calls, for your site, either using the 
values provided or providing your own. Then place an ifile= line into 
each instance-specific init file that points to this file. 


db_name = 
db_files - 20 

db_file_multiblock_read_count = 8 
#db_file_multiblock_read_count = 16 
#db_file_multiblock_read_count = 32 
db__block_buf fers = 200 
#db_block_buffers = 550 
#db_block_buffers = 3200 
shared_pool_size = 3500000 
#shared_pool_size = 6000000 
#shared_pool_size = 9000000 
log_checkpoint_interval = 10000 
processes = 50 
#processes = 100 
#processes = 200 
dml_locks = 100 
#dml_locks - 200 
#dml_locks = 500 
log_buffer = 8192 
#log_buffer = 32768 
#log_buffer = 163840 
sequence_cache_entries = 10 
#sequence_cache_entries = 30 
# sequence_cache_entri.es = 100 
sequence_cache_hash_buckets = 10 
#sequence_cache_hash_buckets = 23 
#sequence_cache_hash_buckets = 89 
#audit_trail = true 
#timed_statistics = true 

#max_dump_file_size = 10240 

#log_archive_start = true 


# SMALL 

# MEDIUM 

# LARGE 

# SMALL 

# MEDIUM 

# LARGE 

# SMALL 

# MEDIUM 

# LARGE 

# SMALL 

# MEDIUM 

# LARGE 

# SMALL 

# MEDIUM 

# LARGE 

# SMALL 

# MEDIUM 

# LARGE 

# SMALL 

# MEDIUM 

# LARGE 

# SMALL 

# MEDIUM 

# LARGE 

# if you want auditing 

# if you want timed 

# statistics 

# limit trace file size 

# to 5 Meg each 

# if you want automatic 

# archiving 












Sample Complex Database 

To plan and build a complex database, you must first plan it carefully. 
Structure your database to include all the tablespaces you will need for 
the various tables, indexes, and so on. Be sure to consult the preceding 
"Using the Standard OFA Configuration" section to determine the rules 
for creating an efficient complex database structure. 

The following sections describe the design and layout of a sample 
complex database. These are not meant to be construed as rules of 
database creation; however, they will show you how a DBA might 
choose to construct a sample complex database. 


Sample system 

Logical database design 

The following table lists the tablespaces in a sample complex database, 
together with the purpose of each. Use this as a framework to create 
your own complex database. You may decide to name your tablespaces 
differently, or have additional tablespaces for other purposes. 


Tablespace 

Purpose 

SYSTEM 

Data dictionary 

ROLLBACK 

Rollback segments 

TEMP 

Temporary tables 

USERS 

User-created tables 

DATA 

Application main data tables 

INDEX 

Application main index tables 

SQLTR_DATA 

SQL*TextRetrieval data tables 

SQLTRJNDEX 

SQL*TextRetrieval index tables 

SQLTRJJSERS 

User-owned tables during SQLTR queries 

MAIL 

ORACLE*MAIL-app generates DBMS alerts 


Table 4-2 Logical Design of a Complex Database 


Physical database design 

The sample complex database has 11 disks devoted to Oracle. Ten of 
these are mounted on /uNN, and one is mounted on /oracle which 
contains $ORACLE_HOME. 
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Note that the DATA, INDEX, SQLTR_DATA, and SQLTRJNDEX 
tablespaces are split across two disks (and therefore two data files) for 
improved performance. 


File layout 

The following is an example of how the DBA has chosen to lay out 
various files in the sample complex database. 

Database files 

The database files are laid out on partitions /u0[l-5] as follows: 

/uOl/oradata/PRG/ 
mail.dbf 
users.dbf 
dataOl.dbf 
sqltr__users. dbf 
controlOl.ctl 

/u02/oradata/PRG/ 

sqltr_data02.dbf 
sqltr_index02.dbf 
data02.dbf 
control02.ctl 

/u03/oradata/PRG/ 
system.dbf 
index02.dbf 
sqltr_data01.dbf 
control03.ctl 

/u04/oradata/PRG/ 
rollback.dbf 
temp.dbf 
indexOl.dbf 
sqltr_index01.dbf 

/u05/oradata/PRG/ 
redoOl.log 
redo02.log 
redo03.log 

Export files 

The export files are laid out on partitions /u0[6-8] as follows: 

/u06/oraexport/PRG/coldexp.dmp (the last "cold" export) 

/u07/oraexport/PRG/hotexp.dmp (the last "hot" export) 
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/u08/oraexport/PRG/hotexp.dmp 


(the previous "hot" export) 


Archived redo log files 

The archived redo logs are laid out on partitions /u09-10 as follows: 

/u09/oraback/PRG/ 

PRG_10003.arc 
PRG_10004.arc 

/ulO/oraback/PRG/ 

PRG_10001.arc (backup) 

PRG_10002.arc (backup) 

Hot and cold backup files 

The hot and cold backup files are laid out on partitions /u0[l-5] as 
follows: 

/u01/oraback/PRG/ 
redoOl.log 
redo02.log 
redo03.log 

/u02/oraback/PRG/ 
mail.dbf 
users.dbf 
dataOl.dbf 
sqltr_users.dbf 
controlOl.ctl 

/u03/oraback/PRG/ 

sqltr_data02.dbf 
sqltr_index02.dbf 
data02.dbf 
control02.ctl 

/u04/oraback/PRG/ 
system.dbf 
index02.dbf 
sqltr_data01.dbf 
control03.ctl 

/u05/oraback/PRG/ 
rollback.dbf 
temp.dbf 
indexOl.dbf 
sqltr_index01.dbf 

Note: The backup files are laid out in a rotation scheme: 
01->02,02->03,03->04,04->05 and 05->01. 
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Placement of Database Files 

When you place your database, redo log, backup, and control files 
correctly, you will see significant improvement in the performance of 
your complex database. In the sample complex database, the DBA has 
chosen to locate the files according to the following guidelines: 

• Backup copies of database files are placed on a separate disk from 
that occupied by the original files. 

• Archived redo logs are stored on a separate disk from that 
occupied by database files or backup copies of database files. 

• Backup copies of archived redo logs are stored on a separate disk 
from that occupied by database files or backup copies of database 
files. 

• Daily database exports are stored on a separate disk from any 
database file, backup copy of a database file, archived redo log or 
another database export. To minimize the effort needed to 
recover and restore a database, daily database exports are kept 
online for two days. 

• Control files are placed on separate disks from each other. Note 
that you can put control files on the same disks as other database 
files. 

Backup Strategies 

You should always have sufficient backup data on disk to recover 
quickly from a minor failure without having to go to tape backup. In 
the sample complex database shown, the DBA has chosen to implement 
the following backup strategies to ensure a smoother, more efficient 
backup of the complex database: 

• Always archive redo logs. 

• Perform daily hot or cold database backups to disk and keep this 
backup data online until the next scheduled database backup. 

• Perform disk backups to tape promptly following database 
backups, so as to minimize chances of losing information on a 
disk. 

• Perform cold database backups at least once a week, so there will 
always be a complete image copy from which to roll forward if 
desired. 

Test your crash recovery strategies for all possible failure scenarios. This 
way, when a failure occurs, you will be able to deal with it better. 
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Testing crash recovery gives the DBA practice in recovering and 
restoring needed data. At the same time, the DBA can compare the 
effectiveness of various crash recovery strategies to determine which is 
most effective for your database. Testing also helps you ensure that 
your tape media and disk backup software are functional, so that when 
your database crashes, recovery is not impeded by malfunctioning 
equipment. 

Backup Policies 

It is important that you have sound backup policies in place before you 
experience any problems with your database. For this sample complex 
database, for example, the DBA has chosen to implement the following 
list of basic backup policies. You may choose to do the same, or you 
may choose to draw up your own backup policies to fit your database 
requirements. 

• Turn on redo log archiving and archive redo logs to disk 
regularly. 

• Perform a "hot" export every night. Save the export file on disk 
for quicker recovery in the event of a disk failure. 

• Perform a "hot" backup every night. Save the backed-up files on 
disk for quicker recovery in the event of a media failure. 

• Perform a "cold" backup weekly and back up the files to disk. 
This will reduce the interval during which the database is 
unavailable. 

• Perform a "cold" export (with database in RESTRICT mode) 
weekly, and back up files to disk. This will reduce the interval 
during which the database is unavailable. 

• Back up all the / u??/ora*/PRG/* files to tape immediately after 
the database backup is done. 

Types of Failure 

Database failure is an unpleasant fact of life for which you must always 
be prepared. The sample complex database structure presented here 
should minimize the effects of any of the following types of failure. You 
may experience any of these types of failure, in which case you will 
need to recover and restore the database from backups and archived 
redo logs. 

• Loss of one disk 
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• Loss of two or more disks 

• Loss of one database file and redo logs 

• Loss of control file 

• Loss of one database file and one or more archived redo logs 

Hot Database Backup 

To perform a "hot" backup of your database, use the following 
instructions: 

1. Check the backup status of all tablespaces by querying the 
v$backup view. 

2. Put one tablespace into backup mode using the ALTER 
TABLESPACE command. 

2.1 Use the 'cp' command to copy the associated database files to 
their alternate location. 

2.2 Take the tablespace out of backup mode using the ALTER 
TABLESPACE command. 

2.3 Repeat Step 2 until all tablespaces have been backed up. 

3. Repeat Step 1 and note the timestamps for correctness. 

4. Back up the control files using the ALTER DATABASE command. 

5. Use the ALTER SYSTEM SWITCH LOGFILE command 

6. Back up the archived redo logs. 

Cold Database Backup 

To perform a "cold" backup of your database, use the following 
instructions: 

1. Shut down the database using SHUTDOWN IMMEDIATE. 

2. Use the 'cp' command to make copies of all database files, control 
files, redo logs, and archived redo logs. 

3. Start up the database. 
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CHAPTER 



Monitoring and Tuning 
Your Oracle System 


T his chapter explains how you can use common UNIX tools to 
monitor and tune the performance of your Oracle system. You can also 
tune your Oracle system parameters to improve performance. 

The topics covered in this chapter are: 


• overview 

• OFA tuning benefits 

• tuning SQL statements 


• memory management 

• disk 1/O performance 

• monitoring CPU usage 

• additional tips 



Additional Information: For more information on tuning 
Oracle system parameters, see your Oracle7 Server 
Administrator's Guide. For more information on tuning your 
specific system parameters, see your Installation and 
Configuration Guide (ICG). 
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Overview 

An important part of tuning your Oracle system is evaluating how your 
system utilizes hardware resources and operating system services. 
Hardware resources include CPU(s), disks, and memory. Operating 
system services include system calls, memory management, and process 
scheduling. Monitoring the usage of such resources and services can 
help you tune your Oracle system to ensure optimum performance. 

This chapter describes a number of additional ways you can maximize 
performance of your Oracle system. Installing your Oracle system in the 
recommended configuration (Optimal Flexible Architecture) will greatly 
improve performance. Likewise, tuning your SQL statements is another 
effective way to improve performance. 

You will need the following information to tune your Oracle system 
optimally: 

• the characteristics of your database application(s) 

These show you how different database objects, such as tables or 
indexes, are accessed, and how big these objects are in terms of 
number of rows, and size of rows. 

• performance data provided by Oracle statistics and system tables 

Oracle statistics show you how many reads and writes are 
performed to each database file. Oracle system tables show you 
which database files hold the data for a given object. 

• your hardware and operating system capabilities 

The performance characteristics of your disks and controllers 
show you if they are overloaded. UNIX tools show you how 
many reads and writes are performed to each disk, and whether a 
given disk is overloaded. If you do not know which disks contain 
which database files, your DBA will. 

Combining data from all these sources helps you correctly evaluate the 
performance of your Oracle system. In evaluating system performance, 
ask yourself the following questions: 

• Are database objects correctly distributed over different disks? 

• Would faster disks improve the performance of the database? 

• Would additional indexes improve the performance of the 
database? 

Note that the arguments and output for the tools described vary from 
system to system. Refer to your ICG for specific information regarding 
your system. 
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Remember that optimizing UNIX for Oracle could affect other 
applications negatively. Read your documentation carefully to ensure 
you know the results of any tuning efforts. 

Before you attempt to tune your Oracle system, be sure the performance 
problems you are experiencing are not due to errors in applications or 
configuration. 

Once you have eliminated these possible causes of problems, see if you 
can identify where performance bottlenecks are occurring. The three 
main areas where bottlenecks tend to occur are: 

• memory 

• I/O subsystem 

• CPU 


OFA Tuning Benefits 

OFA stands for Optimal Flexible Architecture, which is Oracle 
Corporation's recommended configuration for your Oracle system. 
Setting up your Oracle system in the OFA configuration means you can 
accommodate future growth, eliminate free space fragmentation, 
minimize contention for system resources, and reduce any tuning tasks 
you may have to perform. 

The OFA is described in detail in this guide. See the chapter titled 
"Planning a Complex Database," for more information. Procedures for 
installing Oracle in this configuration are described in your ICG. For 
assistance in configuring your system to comply with the OFA, contact 
your regional Oracle Consulting manager. 

Planning Your Database 

By planning your database carefully, you can reduce future tuning tasks. 
Allocate enough space for the different functions of your database, such 
as redo logs, tables, indexes, and so forth. You can adjust the 
appropriate storage parameters as needed. Check the existing default 
parameters with the SQL*DBA command 

SELECT * FROM DBA_TABLESPACES 

Use storage parameters such as INITIAL, NEXT, MINEXTENTS, 
MAXEXTENTS, and PCTINCREASE to allocate more or less space for 
tables, indexes, and so forth. 
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Tuning SQL Statements 

Poorly tuned SQL statements are a significant cause of performance 
problems. If you notice that your system is performing sluggishly, be 
sure to check your SQL statements before tuning memory, I/O, or 
CPU(s). 


Often, SQL statements can consume more than their fair share of 
resources. To verify that your system problems are caused by poor SQL 
statements, run a tkprof report for all Oracle application processing. 
SQL statements showing excessive execution times or a CR/Rows 
(Concurrent Reads per Rows Returned) ratio greater than 15 should be 
checked to ensure they are not the cause of poor performance, and 
should be rewritten as required. 

You can also use EXPLAIN PLAN, another SQL tool, to see how your 
system is using indexes for specific queries. Improper index use can 
contribute greatly to performance deterioration. 


If you find you are still experiencing poor performance, after you install 
and configure your Oracle system according to the OFA guidelines, and 
tune your SQL statements to run at optimum efficiency, analyze system 
performance in the following order: 


• memory management 

• disk I/O 
. CPU 



Additional Information: For more information on SQL 
statements, and how to tune them, see your Oracle RDBMS 
Performance Tuning Guide. 
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Memory Management 


System Global Area 


Size of the SGA 


This section discusses memory usage and management, and tells you 
how to tune memory. Memory management is important because 
Oracle tends to be memory-intensive. No application runs on a machine 
with unlimited memory resources, so this section discusses paging and 
swapping as well. 


The System Global Area (SGA) comprises a set of memory buffers 
allocated by the Oracle Server that contain data and control information 
for one Oracle Server database instance. An SGA and the Oracle Server 
background processes constitute an Oracle Server database instance. 



Additional Information: For more information on the SGA, 
see the "Oracle System Architecture Under UNIX" chapter in 
this guide. For information on background processes and 
database instances, and tuning SGA parameters, see the Oracle 
Server Concepts Manual. 


The main components of the SGA are database buffers, redo log buffers, 
the shared pool, and cursors. For the Oracle Server on UNIX, the SGA is 
a piece of shared memory that is attached to all background and server 
processes. Some areas of concern when dealing with the UNIX SGA are: 


• size 


• placement 

• number of shared memory segments 
These are discussed in the following sections. 


You must ensure that your UNIX system kernel has enough shared 
memory to allow for the creation of the SGA. The amount of shared 
memory allowed on a UNIX system is determined by UNIX kernel 
parameters. 

On BSD-based UNIX systems, adjust the following parameters: 

SHMSIZE maximum size of the shared memory segment, in 1 

Kb blocks 

SHMALL or maximum size of the shared memory segments 

SHMINI allowed systemwide 

On UNIX System V, adjust the following parameters: 
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Placement of the SGA 


SHMMAX maximum size of the shared memory segment in 

bytes 

SHMALL or maximum number of shared memory segments or 

SHMINI identifiers allowed systemwide 

Additional Information: For more information on additional 
0 = le shared memory parameters, see the "Issues and Restrictions" 
chapter of your ICG. 

The consequences of having a larger SGA is that the Oracle Server uses 
more memory and induces more paging on your system. It is acceptable 
to have parts of the the SGA paged out. However, if your large SGA is 
inducing swap outs or heavy, prolonged paging, consider adding more 
memory. 


To understand placement of the SGA, you need to analyze the shared 
pool and cursor components of the SGA. The shared pool is an area in 
the SGA containing shared memory constructs such as shared SQL 
areas. A cursor is the handle for the memory associated with a specific 
statement. Thus, a cursor is a name or pointer to the memory used to 
process a specific SQL statement. 

Note that placement of the SGA will vary, depending on your platform. 
Incorrect placement of the SGA can cause problems. 

Additional Information: For detailed information about SGA 
0 = k placement, the shared pool area, and cursors, see the Oracle 
Server Administrator's Guide. 



Additional Information: For information about 
platform-specific SGA placement, see your ICG. 


Swapping and Paging 

As almost all UNIX systems support swapping and demand paging, 

you need to familiarize yourself with the following terms. 

swapping Swapping refers to copying an entire process image 

from memory to disk to free up memory for other 
uses. 

paging Paging means moving pages of a process to disk 

temporarily in order to free up memory. This 
allows the active parts of a process to remain in 
memory. 
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demand paging 


Instead of copying an entire process into memory, 
which requires space, the UNIX kernel only sets up 
the memory map of the newly forked processes and 
allows the paging mechanism to read in parts of the 
process as needed. 


The kernel does not arbitrarily page processes out to disk. It uses an 
algorithm to determine the least-used pages on the system. Thus, if part 
of the SGA is paged out, the kernel has decided there are other processes 
that need the memory more. The key is to minimize page outs and 
swap outs on the entire system. Your Oracle7 system will run better, as 
will other applications sharing the machine. 

Swap space should be equal to memory, at least. A good rule of thumb 
is to set up two to three times more swap space than total available 
memory. 


Monitoring Paging and Swapping 


Use one of the following UNIX commands to monitor paging and 
swapping. 

On BSD, enter vmstat -S and note the following columns: 


procs the number of processes swapped out 


page 


so 


po 

de 


the number of page outs 
anticipated page memory shortfall 
the number of swap outs 


memory 


avm 


fre 


the number of active virtual Kb 
size of the free list in Kb 
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On System V, enter sar -rwp and note the following columns: 


freeswap 

swpot/s 

bswot/s 

vflt/s 

rclm/s 


the amount of free swap space available on your sys¬ 
tem 

average number of swap outs per second 

the average number of 512 bytes swapped out per se¬ 
cond 

virtual memory faults per second 

average number of pages reclaimed per second 


Key indicators include the following: 

• page outs or vflt/s is high. The system is probably paging too 
much. 

• swap outs, anticipated page memory shortfall, or reclaim pages 
is true. The system is doing heavy swapping; this may indicate 
memory shortfall. 

Swapping on a recurring basis degrades performance. However, keep 
in mind that certain non-Oracle Server processes, such as very idle 
processes, are getting swapped out and not affecting Oracle Server 
performance. Also, to monitor performance, you should look at the 
history of swapping on your machine to ensure that, in fact, it has been 
occurring steadily over an extended period of time. Do not be 
concerned if swapping occurs over short intervals. 

If your system is paging and swapping excessively, do the following: 

For all systems: 

• If possible, add more memory, then tune the kernel so that the 
new memory is not used for the buffer cache. 

For BSD: 

• Increase lotsfree to reduce the likelihood of your system doing 
swapping. 

• Decrease desfree to reduce the likelihood of your system doing 
desperation swapping. 

For System V: 

• Increase gpgslo to reduce the likelihood of paging. 







Monitoring Memory Usage 


Use one of the following commands to monitor memory usage for your 
UNIX operating system. 

For BSD, use the fremem column of vmstat to monitor memory usage. 

It gives the amount of free memory currently available for process use, 
in kilobytes. 

For System V, use the freemem column under the sar -r report to 
monitor memory usage. It gives the amount of free memory available in 
pages. 
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Disk I/O Performance 


Typically, database applications make heavy use of I/O resources, so 
tuning I/O resources is an important part of tuning the system. If your 
Oracle system becomes 1/O-bound, you will see a decrease in 
performance without a corresponding CPU or memory problem. 
Symptoms include: 

• Checking on CPU usage reveals plenty of CPU resources 
available, but long waits for I/O, slow performance, and slow 
throughput. 

• The number of blocked processes reported by vmstat is greater 
than zero for extended periods; wio% is high, and consistently 
greater than 20. 

• On filesystems, %rcache is less than 90 and %wcache is less than 
60, and there are long disk queues, or response is sluggish. 

Note that if during heavy load periods, your overall performance 
decreases dramatically but CPU idle time is greater than 15%, your 
system may be disk I/O-bound and possibly memory-bound as well. 

Check both your disk and controller usage to ensure that your system is 
optimally tuned. 


Disk Reads and Writes 

Tuning disk I/O performance includes determining whether your 
system is I/O-bound, or memory-bound, and which of many options to 
use to improve performance. For example, more disks, faster disks, and 
better distribution of data across disks are all effective in tuning an 
1/O-bound system. Which option, or combination of options, you use 
depends on your answers to the following questions: 

1. How many reads or writes per second are occurring on each disk? 

This information helps you determine if any disks are overloaded or 
if I/O is unevenly distributed across your disks. To find the 
information: 

On BSD see the tps (transfers per second) column of iostat 

On System V see the r+w/s (reads and writes per second) col¬ 

umn of sar-d 

2. How big are the reads or writes to each disk? 
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On BSD see the bps (blocks per second) column of iostat 

On System V see the blks/s (blocks per second) column of sar 

-d 

3. Are the reads and writes randomly scattered around the disk, or are 
they sequential? 

This depends on the application and database layout. 

4. How long does it take a process to perform a read or write on a 
given disk? 

On System V see the avwait (average wait) and avserv (average 
service time) columns of sar -d 

5. Are many processes waiting for I/O on a given disk? 

This will will help you identify specific disks with a bottleneck 
problem. 

On System V the avque (average queue length) column of sar 

-d 

6. How many I/Os per second occur on each controller? 

In addition to limits on how many reads and writes a disk can 
perform, your system may have limits on how many reads and 
writes per second a controller can perform. 

On BSD and on System V: 

Ask your system administrator which disks are on which 
controllers, and combine this data with the information on the the 
number of reads and writes per disk to get the number of I/Os per 
second to each controller. 

7. Are the database files raw partitions or UNIX file system files? 

8. Your DBA can tell you if your database files are UNIX file system 
files; if so, you need to look at file system statistics as well as disk 
statistics. Typically, database file names indicate whether a file is a 
file system file or a raw partition. 
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On System V, enter sar -b for buffer cache statistics and read the 
following columns: 


bread/s, bwrit/s 

pread/s, pwrit/s 

lread/s, lwrit/s 

%rcache, 

%wcache 


blocks read into and blocks written from system 
buffer cache 

physical reads and writes 

reads from and writes to the buffer cache 

percentage of read and writes satisfied from the 
buffer cache 


9. How much time is spent waiting for I/O? 

On BSD, enter vmstat and read the following columns: 

(procs) b number of processes blocked 

(cpu) id percentage of CPU idle time 

On System V, enter sar -u and read the following column: 

% wio percentage of CPU time waiting on blocked I/O 


Monitoring I/O 

To monitor I/O effectively: 

• Use the SQL*DBA monitor file I/O statistics and match database 
I/O to I/O reported by UNIX tools. 

• If possible, distribute I/O evenly over disks and controllers. 

One technique for distributing I/O evenly over disks is disk 
striping. Striping refers to the dividing of a large table's data into 
small portions and storing these portions in separate data files on 
separate disks. When you utilize striping, you can use multiple 
processes to access different portions of the table concurrently 
without running into disk contention. Striping is particularly 
helpful in optimizing random access to tables with many rows. 

jr^ Additional Information: For detailed steps used in creating a 
lo~iJ striped table, see the Oracle Server Administrator's Guide. 
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CPU Usage 


One good way to get an overview of where your system spends its time 
is to monitor CPU usage. This will help you decide where to 
concentrate your tuning efforts. For example, if the CPU often waits for 
I/O, you should examine your I/O system. If the CPU spends a lot of 
time in the operating system, you should evaluate the system calls and 
operating system services being used. 

Note: Be sure to consider whether your system is a 
multiprocessor or uniprocessor when evaluating CPU usage. 
For example, if your system has ten CPUs and only one process 
is running, a CPU usage of 10% means the process is using as 
much CPU as it can. If your system has only one CPU and only 
one process is running, a CPU usage of 10% means the process 
is idle or waiting for I/O much of the time. 


Monitoring CPU Performance 

To gather information regarding CPU performance statistics, use one of 
the following commands: 


On BSD, enter vmstat and check the following columns: 

us 

percent of CPU time spent in user state 

sy 

percent of CPU time spent in system state 

id 

percent of CPU idle 

On System V, enter 

sar -u and check the following columns: 

%usr 

percent of CPU time spent in user state 

%sys 

percent of time spent in system state 

%idle 

percent of CPU idle 


General Guidelines 

This data shows how the CPU is used, and is directly affected by what 
your application is doing. If the data shows evidence of a CPU 
bottleneck, evaluate your application to ensure it is using CPU 
efficiently. 

If your CPU idle time at peak load is 0%, check whether end users are 
experiencing an appreciable degradation in performance or response 
time. Although this judgment is subjective, it is important in helping 
you evaluate your system. 
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Consider getting a faster CPU, or more CPUs for a multiprocessor 
machine, if your CPU performance data shows all the following 
symptoms: 

• CPU idle time is often 0%. 

• CPU time spent in user state is larger than CPU time spent in 
system state. 


Additional Tips 

Most of the work involved in tuning your database is independent of 
the operating system you use. 

Additional Information: For general database tuning 
information, see the Oracle7 Server Concepts Manual and the 
Orac\e7 Server Administrator's Manual. 

By tuning Oracle Server, you can tailor its performance to best meet 
your needs. The following topics are discussed briefly in this section: 

• client/server option 

• advantages and disadvantages of using raw devices 

Additional Information: For more information about tuning 
lo=iJ your system, see the Oracle Server Administrator's Guide. 

Client/Server Option 

Consider the following issues before you select a client/server Oracle 
Server environment. 

Analyze your system's current performance problems in the single-node 
environment. For example, if your system suffers from a poorly tuned 
I/O system (slow disks, unbalanced I/O), then moving to client/server 
may not help you. This is because, in most cases, moving to 
client/server will not significantly change the I/O behavior of your 
database. 

Analyze the general health of your current network. If your network is 
already heavily bogged down, you may not want to add to the network 
burden by setting up an Oracle client/server environment. Use netstat 
-i to determine packet error and collisions. Errors should be less than 
0.5% of total packets and collisions greater than 10% of total packets. 
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Additional Information: For a discussion about detecting latch 
contention and other ways to improve performance, see the 
Oracle Server Administrator's Guide. 


Raw Devices 

Raw devices allow the Oracle Server to bypass the UNIX buffer cache 
because database files are not placed in file system files, but on 
unformatted "raw" slices of the hard disk instead. 


Advantages of using raw devices 

The advantages of using raw devices include faster performance and 
savings in memory usage. Faster performance occurs because the 
Oracle Server is bypassing the UNIX buffer cache. Memory savings 
occur because the Oracle Server does not use the UNIX buffer cache for 
database block reads and writes. 

Disadvantages of using raw devices 

The disadvantages of using raw devices include the demands of 
implementation and backing up. With raw devices you must devote an 
entire disk partition to a single database file. This may lead to a lot of 
wasted disk space or shortages of disk space, unless you plan and size 
your database very carefully. Furthermore, backing up raw devices 
tends to be a cumbersome and complicated procedure compared with 
backing up filesytem database files. 


Additional Information: For detailed information about how 
to set up and back up your database system on raw devices, see 
the "Oracle System Administration" chapter of your ICG. For 
more information, see also the "Planning a Complex Database" 
chapter in this guide. 


Creating System V UNIX File Systems 

On System V file systems, the larger the block size, the greater potential 
throughput, but at the cost of storage efficiency and increased 
fragmentation. 

The default number of inodes is always very generous, so you may want 
to consider adjusting it. 

There is no significant performance difference between BSD file systems 
and System V file systems because of the way the Oracle Server uses the 
SGA to buffer database blocks. You should, therefore, make Oracle 
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Server block sizes match disk block sizes. If they do not match, make 
the Oracle Server block size a multiple of the disk block size. 

If possible, use the commands fsck and newfs to check and enhance file 
system consistency in the partition before using it for database files. 

This will help prevent file system fragmentation. 

Creating BSD UNIX File Systems 

If the file system in question is only being used for Oracle database files, 
perform the following steps to tune it optimally: 

1. raise maxbpg 

2. set minfree=0 

This should increase your available disk space by approximately 
10% (ten percent). 

3. raise nbpi 

4. raise cgsize 

Additional Information: For details on the above parameters, 
see the man pages on makefs and tunefs. 

Setting Up Raw Partitions 

When partitioning and formatting a disk drive, remember the following: 

• avoid using the first cylinder in the a partition for non-root file 
systems or raw partitions 

• always partition by cylinder boundaries 
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CHAPTER 


Oracle XA Library 



1 J[* his chapter describes how to administer and use the Oracle XA 
library interface. 

The topics covered in this chapter are: 

• overview of the Oracle XA library 

• developing and installing applications 

• interfacing to precompilers and Oracle Call Interfaces (OCls) 

• troubleshooting 

• restrictions 


Oracle XA Library 
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XA-Related Information 


General Information for the Oracle XA Library 




Additional Information: For preliminary reading and 
additional reference information regarding the Oracle XA 
library, see the following documents: 

Programmer's Guide to the Oracle Precompilers vl.5 
Programmer's Guide to the Oracle Call Interface 
Oracle Server SQL Language Reference Manual 

Additional Information: For platform-specific information on 
library linking filenames, see your ICG . 


README.doc 


The README.doc file located in the $ORACLE_HOME/xa/doc 
directory describes changes, bugs, or restrictions in the Oracle XA 
library since the last version. The README.doc file is an online 
supplement to the printed documentation. 


Basic Architecture 


The Oracle XA library is an external interface that allows global 
transactions to be coordinated by a transaction manager other than the 
Oracle Server. This allows inclusion of non-Oracle Server entities called 
resource managers (RM) in distributed, two-phase commit transactions. 
The Oracle XA library conforms to the X/Open Distributed Transaction 
Processing (DTP) software architecture's XA interface specification. 

Note: For a general overview of XA, including basic 
architecture, see X/Open CAE Specification - Distributed 
Transaction Processing: The XA Specification. You can obtain a 
copy of this document from the X/Open Company at 1010 El 
Camino Real, Suite 380, Menlo Park, CA 94025, U.S.A. by 
requesting ISBN 1 872630 24 3 or X/Open Document No. 
XO/CAE/91/300. 

X/Open Distributed Transaction Processing (DTP) 

The X/Open DTP architecture defines a standard architecture or 
interface that allows multiple application programs to share resources 
provided by multiple, and possibly different, resource managers. It 
coordinates the work between application programs and resource 
managers into global transactions. 
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The figure below illustrates the X/Open DTP architecture. 



Figure 6-1 X/Open Distributed Transaction Processing Architecture 

A resource manager (RM) controls a shared, recoverable resource that 
can be returned to a consistent state after a failure. For example, Oracle 
Server is an RM and uses its redo log and undo segments to return to a 
consistent state after a failure. An RM provides access to shared 
resources such as a database, file systems, printer servers, and so forth. 

A transaction manager (TM) provides an application program interface 
(API) for specifying the boundaries of the transaction and manages the 
commit and recovery procedures. Normally, Oracle Server acts as its 
own TM and manages its own commit and recovery. However, using a 
standards-based TM allows Oracle Server to cooperate with other 
heterogeneous RMs in a single transaction. A TM is usually a 
component provided by a transaction processing monitor (TPM) vendor. 
The TM assigns identifiers to transactions, and monitors and 
coordinates their progress. It uses Oracle XA library subroutines to tell 
Oracle Server how to process the transaction, based on its knowledge of 
all RMs in the transaction. You can find a complete list of all the XA 
subroutines and their descriptions later in this section. 

An application program (AP) defines transaction boundaries and 
specifies actions that constitute a transaction. For example, an AP can be 
a precompiler or OCI program. The AP operates on the RM's resource 
through the RM's native interface, for example SQL. However, it starts 
and completes all transaction operations via the transaction manager 
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through an interface called TX. The AP itself does not directly use the 
XA interface. 

Note: The naming conventions for your TX interface and 
associated subroutines are vendor-specific, and may differ from 
those used here. For example, you may find that the tx_open 
call is referred to as tp_open on your system. To check on 
terminology, refer to the documentation supplied with your 
transaction processing monitor. 

Two-phase commit protocol 

The Oracle XA library interface follows the two-phase commit protocol, 
consisting of a prepare phase and a commit phase, in order to commit 
transactions. 

In phase one, the prepare phase, the TM asks each RM to guarantee the 
ability to commit any part of the transaction. If this is possible, then the 
RM records its prepared state and replies affirmatively to the TM. If it is 
not possible, the RM may roll back any work, reply negatively to the 
TM, and forget any knowledge about the transaction. The protocol 
allows the application or any RM to roll back the transaction unilaterally 
until the prepare phase is finished. 

In phase two, the commit phase, the TM records the commit decision. 
Then the TM issues a commit or rollback to all RMs which are 
participating in the transaction. Note that a TM can issue a commit for 
an RM only if all RMs have replied affirmatively to phase one. 

Oracle XA library interface subroutines 

The Oracle XA library subroutines allow a TM to instruct Oracle Server 
what to do about transactions. Generally, the TM must "open" the 
resource (using xa_open). Typically, this will result from the AP's call to 
tx_open. Some TMs may call xa_open implicitly, when the application 
begins. Similarly, there is a close (using xa_close) that occurs when the 
application is finished with the resource. This may be when the AP calls 
tx_close or when the application terminates. 

There are several other tasks the TM instructs the RMs to do. These 
include: starting a new transaction and associating it with an ID; rolling 
back a transaction; preparing and committing a transaction; and others. 
A complete list of all the subroutines and their descriptions follows. 

xa_open connect to the resource manager 

xa_close disconnect from the resource manager 
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xa_start 

start a new transaction and associate it with the 
given transaction ID (XID), or associate the process 
with an existing transaction 

xa_end 

disassociate the process from the given XID 

xa_rollback 

roll back the transaction associated with the given 
XID 

xa_prepare 

prepare the transaction associated with the given 
XID. This is the first phase of the two-phase 
commit protocol. 

xa_commit 

commit the transaction associated with the given 
XID. This is the second phase of the two-phase 
commit protocol. 

xa_recover 

retrieve a list of prepared, heuristically committed 
or heuristically rolled back transactions 

xa_forget 

forget the heuristic transaction associated with the 
given XID 

xa_complete 

wait for completion of an asynchronous operation 


In general, the AP does not need to worry about these subroutines 
except to understand the role played by the xa_open string. 


Transaction Processing Monitors (TPMs) 

Under UNIX, a transaction processing monitor (TPM) is a tool that 
coordinates the flow of transaction requests between client processes 
that issue requests and back-end servers that process them. Basically, a 
TPM coordinates transactions that require services of several different 
types of back-end processes, such as application servers and resource 
managers that are distributed over a network. 

The TPM synchronizes any commits and rollbacks required to complete 
a distributed transaction request. The transaction manager (TM) portion 
of the TPM is responsible for controlling when distributed commits and 
rollbacks take place. Thus, if a distributed application program is 
written to take advantage of a TPM, the TM portion of the TPM is 
responsible for controlling the two-phase commit protocol. The RMs 
enable the TMs to do this. 

Because the TM controls distributed commits or rollbacks, it must 
communicate directly with the Oracle Server (or any other resource 
manager). It communicates through the Oracle XA library interface. 
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Required Public Information 


Additional XA Issues 


As a resource manager, Oracle is required to publish the following 
information: 


xa_switch_t 

structure 


xa_switch_t 

resource mgr 

close string 


open string 


libraries 


requirements 


The Oracle Server xa_switch_t structure name is 
xaosw. This structure contains entry points and 
other information for the resource manager. 

The Oracle Server resource manager name within 
the xa_switch_t structure is Oracle_XA. 

The close string used by xa_close () is ignored and 
may be null. 

The format of the open string used by xa_open () is 
described in detail later in this chapter under the 
section titled "Developing and Installing 
Applications." 

Libraries needed to link applications using Oracle 
XA have platform-specific names. In general, it is 
similar to linking an ordinary precompiler or OCI 
program except with one additional library 
($ORACLE_HOME/lib/libxa.a), and any 
TPM-specific libraries. Refer to your ICG and the 
Oracle XA README.doc file for your particular 
machine to find the correct library name. 

Use of the Oracle XA library restricts the use of SQL 
to connect to and disconnect from the database and 
to perform transaction operations. These 
restrictions are described in detail in the section 
titled "Interfacing to Precompilers and OCIs" later 
in this chapter. 

You must have purchased and installed the 
distributed database option. 


Note the following additional information about Oracle XA issues: 


DDL statements 


global and local 
transactions 


Oracle applications in global transactions may not 
perform DDL statements (like CREATE TABLE, 
DROP TABLE, CREATE INDEX) because they force 
a commit of pending work. 

When an application uses the XA library to connect 
to the Oracle Server, that application can only 
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transaction 

branches 


read-only 

association 

migration 


dynamic 

registration 

asynchronous 

calls 


operate on global transactions. The Oracle Server 
does not allow local transactions when it is using 
XA. 

Oracle Server transaction branches within the same 
global transaction share locks in a tightly coupled 
manner. However, if the branches are on different 
instances when running Oracle Parallel Server, then 
they are loosely coupled. 

Oracle Server supports the read-only optimization. 

Oracle Server does not support association 
migration (a means whereby a transaction manager 
may resume a suspended branch association in 
another branch). 

The optional XA feature dynamic registration is not 
supported. 

The optional XA feature asynchronous XA calls is 
not supported. 
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Developing and Installing Applications 

This section discusses developing and installing Oracle Server 
applications. It describes the responsibilities of both the DBA, or system 
administrator, and the application developer. It also defines how to 
construct the open string. 


Responsibilities of the DBA or System Administrator 

The responsibilities of the DBA or system administrator are: 

1. Define the open string in conjunction with the application 
developer. 

Defining the open string is described later in this section. 

2. Make sure the V$XATRANS$ view exists on this database. 

This view should have been created during the the XA library 
installation. You can manually create the view if needed by running 
the SQL script $ORACLE_HOME/xa/admin/xaview.sql. This SQL 
script should be executed under the Oracle Server user sys. Grant 
the SELECT privilege to the V$XATRANS$ view for all Oracle 
Server accounts which will be used by Oracle XA library 
applications. 

3. Define additional server security groups if needed. 

Server groups are described under the clause that sets them in the 
open string. 

4. Install the resource manager, using the open string information, into 
the TPM configuration. 

Do this according to the TPM vendor instructions. The DBA or 
system administrator should be aware that a TPM system will start 
the process that connects to Oracle Server. Check the TPM 
documentation to determine what environment exists for the 
process and what user ID it will have. Be sure that correct values 
are set for ORACLE_HOME and ORACLE_SIO. Also be sure to 
grant the user ID write permission to the directory in which the XA 
trace file will be written. See the section, "Defining the Open 
String" for information on how to specify a sid or a trace directory 
that is different from the defaults. 

5. Start up the relevant databases to bring Oracle XA applications 
online. 

This should be done before starting any TPM servers. 
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Responsibilities of the Application Developer 


The application developer's responsibilities are: 

1. Define the open string in conjunction with the DBA or system 
administrator. 

2. Develop the applications. 

Observe special restrictions on transaction-oriented SQL statements 
for precompilers. Refer to the section titled "Interfacing to 
Precompilers and OCIs," later in this chapter. 

3. Link the application according to TPM vendor instructions. 

Refer to your ICG for specific information on the exact libraries 
needed. 


Defining the Open String 

This section describes how to construct the open string. This string is 
used by the transaction monitor to open the database. The maximum 
number of characters in an open string is 256. The syntax of the open 
string is summarized as follows; later sections provide more detail on 
required and optional fields. 

Oracle_XA| +requiredjields...\ [^optional Jields...] 

where required Jields are: 

Acc=P// 

or 

Acc=P/ user/password 
S esTm =session_time_l i m i t 
and where optional Jields are: 

T)B=db_name 
GPwd=P /group ^password 
LogDir =log_dir 

MaxCur=maximum_#_of_open_cursors 
SqlNet =connect_string 
Note the following: 

• You can enter the required fields and optional fields in any order 
when constructing the open string. 
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• All field names are case insensitive. Their values may or may not 
be case-sensitive depending on the platform. The value of each 
field will be case-sensitive on most UNIX platforms. 

• There is no way to use the "+" character as part of the actual 
information string. 


Required fields 

Required fields for the open string are described in this section. 

Acc=P// 

or 

Acc=P luser/password. 

Acc Specifies user access information. 

P Indicates that explicit user and password 

information is provided. 

P// Indicates that no explicit user or password 

information is provided and that the operating 
system authentication form will be used. For more 
information see the section "Managing Users and 
Resources," in the Oracle Server Administrator's 
Guide. 

user A valid Oracle Server account. 

password The corresponding current password. 

For example, Acc=P/scott/tiger indicates that user and password 
information is provided. In this case, the user is scott and the password 
is tiger. 

As previously mentioned, make sure that scott has the SELECT 
privilege on the V$XATRANS$ table. 

Acc=P// indicates that no user or password information is provided, 
thus defaulting to operating system authentication. 

SesTm -session JimeJimit 

SesTm Specifies the maximum length of time a transaction 

can be inactive before it is automatically deleted by 
the system. 

session JimeJimit This value should be the maximum time allowed in 

a transaction between one service and the next, or a 
service and the commit or rollback of the 
transaction. For example, if the TPM uses remote 
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procedure calls between the client and the servers, 
then SesTM applies to the time between the 
completion of one RPC and the initiation of the next 
RPC, or the tx_commit, or the tx rollback. 

The unit for this time limit is in seconds. The value 
of 0 indicates no limit, but entering a value of 0 is 
strongly discouraged. 

For example, SesTM=15 indicates that the session idle time limit is 15 
seconds. 


Optional fields 

Optional fields are described below. 

DB=db_name 

DB Specifies the database name 

db_name Indicates the name used by Oracle precompilers to 

identify the database. 

Application programs that use only the default 
database for the Oracle precompiler (that is, they do 
not use the AT clause in their SQL statements) 
should omit the DB =db_name clause in the open 
string. 

Applications that use explicitly named databases 
should indicate that database name in their 
DB=db_tinme field. 

OC1 programs need to call the sqlld2() function to 
obtain the correct connection. Refer to the section 
titled "Using OCIs with the Oracle XA Library," 
later in this chapter. 

The dbjiame is not the sid and is not used to locate 
the database to be opened. Rather, it correlates the 
database opened by this open string with the name 
used in the application program to execute SQL 
statements. The sid is set from either the 
environment variable ORACLE_SID of the TPM 
application server or the sid given in the SQL*Net 
clause in the open string. The SQL*Net clause is 
described later in this section. 

Some TPM vendors provide a way to name a group 
of servers that use the same open string. The DBA 
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may find it convenient to choose the same name 
both for that purpose and for dhjname. 

For example, DB=payroll indicates that the database name is "payroll", 
and that the application server program will use that name in AT 
clauses. 

For more information about precompilers (specifically Pro*C), refer to 
the section titled "Interfacing to Precompilers and OCIs," later in this 
chapter. 

G P w d=P Igrou pjpassword 

GPwd Specifies the server security group password. 

P Indicates that an explicit server security group 

password is currently provided. 

group,__passzvord Indicates the actual server security group password. 

Server security groups provide an optional extra 
layer of protection between different applications 
running against the same Oracle Server instance. If 
no server security group option is specified, then 
the application using this open string will be part of 
an Oracle Server-defined server security group. 

A transaction must be executed wholly within a 
server security group. For example, if a debit 
application specifies a different Oracle Server 
security group than a credit application, then the 
two may not be used in the same transaction. 

For example, GPwd=P/banking indicates that the current server group 
password is "banking". 

LogDir =log_dir 

Specifies the directory on a local machine where the 
Oracle XA library error and tracing information 
may be logged. 

Indicates the pathname of the directory where the 
tracing information should be stored. The default is 
$ORACLE_HOME/rdbms/log if ORACLE HOME 
is set, otherwise it is the current directory. 

For example, LogDir=/xa_trace indicates that the error and tracing 
information is located under the /xa_trace directory. 


LogDir 


log_dir 
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Note: Make sure the directory you specify for logging exists and the 
application server can write to it, otherwise useful trace files may be lost 
without any error indication. 

MaxCur=maximum_#-Of_open_cursors 

MaxCur Specifies the number of cursors to be allocated 

when the database is opened. It serves the same 
purpose as the precompiler option 

maxopencursors. 

maximum Indicates the number of open cursors to be cached. 

open _cursors 

For example, MaxCur=5 indicates that the precompiler should try to 
keep five open cursors cached. 

Note: This parameter overrides the precompiler option 
maxopencursors that you might have specified in your source code or at 
compile time. 

For more information on maxopencursors, refer to the chapter in the 
Programmer's Guide to Oracle Precompilers vl.5 that discusses 

maxopencursors. 

SqlNet -connect _string 

Specifies the SQL*Net connect string. 

Indicates the string to use to log on to the system. 
The syntax for this string is the same as that used to 
set the TWO-TASK environment variable. The 
connect string can be either a SQL*Net vl string, a 
SQL*Net vl alias, or a SQL*Net v2 alias. Aliases are 
recommended if you use SQL*Net v2 to reduce the 
total length of the open string. Refer to the TARG 
for details on the connect string to use with any 
SQL*Net protocol or adapter. 

For example, SqlNet=T:hqfin:NEWDB indicates the database with 
s/rf=NEWDB accessed at host hqfin by TCP/IP. 

The SqlNet parameter can be used to specify the ORACLE SID in cases 
where you cannot control the server environment variable. It must also 
be used when the server needs to access more than one Oracle Server 
database. To use the SQL*Net string without actually accessing a remote 
database, specify the use of the Pipe driver. For SQL*Net vl, an 
example would be: 

SqlNet-P:localdb 


SqlNet 

connect _string 
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Examples 


This string accesses the database with sid localdb using the standard 
two-task connection mechanism. 

For SQL*Net v2, an example would be: 

SqlNet=localsidl 

where: 

localsidl is an alias defined in the SQL*net tnsnames.ora file. 

Make sure that all databases to be accessed with a SQL*Net string have 
an entry in /etc/oratab. 


Examples of information strings using the above information follow. 

Note: If the string is more than one line, refer to your TPM 
vendor documentation for information about how to split up 
the string. 

Oracle_XA+Acc=P/scott/tiger+SesTm=23 
Oracle_XA+SqlNet=T:hqfin:SID+Acc=P/scott/tiger+ 
GPwd=Dallas+SesTm=23+LogD=. 

Oracle_XA+DB=finance+SqlNet=T:hqpay:SID+Acc=P/scott/tiger+ 
GPwd=Dallas+SesTM=23+LogD=. 
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Interfacing to Precompilers and OCIs 

This section describes how to use the Oracle XA library in conjunction 
with precompilers and Oracle Call Interfaces (OCIs). 

Using Precompilers with the Oracle XA Library 

When used in an Oracle XA application, cursors are valid only for the 
duration of the transaction. Explicit cursors should be opened after the 
transaction begins, and closed before the commit or rollback. Also, you 
must use the release_cursor=yes option when compiling your 
precompiler application. 

There are two options to choose from when interfacing with 
precompilers: 

• using precompilers with the default database 

• using precompilers with a named database 
The following examples use the precompiler Pro*C. 

Using precompilers with the default database 

To interface to a precompiler with the default database, make certain 
that the UB=db_name field, used in the open string, is not present. The 
absence of this field indicates the default connection as defined by 
sqllib, and only one default connection is allowed per process. 

The following is an example of an open string identifying a default 
Pro*C connection. 

ORACLE_XA+SqlNet=T:host:MAIL+ACC=P/scott/tiger+GPwD=P/mailgrp 
+SesTM=10+LogDir=/usr/local/logs 

Note that the DB =db_name is absent, indicating an empty database ID 
string. 

The syntax of a SQL statement would be: 

EXEC SQL UPDATE EMP SET SAL = sal *1.5; 

Using precompilers with a named database 

To interface to a precompiler with a named database, include the 
DB =db_name field in the open string. Any database you refer to must 
reference the same dbjmme you specified in the corresponding open 
string. 

An application may include the default database, as well as one or more 
named databases, as shown in the following examples. 
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For example, suppose you want to update an employee's salary in one 
database, her department number (DEPTNO) in another, and her 
manager in a third database. You would configure the following open 
strings in the transaction manager: 

ORACLE_XA+DB=MANAGERS+SqlNet=T:hqfin:SID1+ACC=P/scott/tiger 
+GPwd+P/pay+SesTM=10+LogDir=/usr/local/xalog 
ORACLE_XA+DB- PAYROLL*SqlNet = P:SID2+ACC= P/scott/tiger 
+GPwd=P/mgr+SesTM=10+LogDir=/usr/local/xalog 
ORACLE_XA+SqlNet=T:hqemp:SID3 +ACC = P/scott/1iger+GPwd=P/mgr 
+SesTM=10+LogDir=/usr/local/xalog 

Note that there is no DB=db_name field in the last open string. 

In the application server program, you would enter declarations such as: 

EXEC SQL DECLARE PAYROLL DATABASE; 

EXEC SQL DECLARE MANAGERS DATABASE; 

Again, the default connection (corresponding to the third open string 
that does not contain the db_name field) needs no declaration. 

When doing the update, you would enter statements similar to the 
following: 

EXEC SQL AT PAYROLL UPDATE EMP SET SAL=4500 WHERE EMPNO=7788; 

EXEC SQL AT MANAGERS UPDATE EMP SET MGR=7566 WHERE EMPNO=7788; 

EXEC SQL UPDATE EMP SET DEPTNO=30 WHERE EMPNO=7788; 

There is no AT clause in the last statement because it is referring to the 
default database. 

In precompilers vl.5.3 or later, you can use a character host variable in 
the AT clause, as the following example shows: 

EXEC SQL BEGIN DECLARE SECTION; 

DB_NAMEl CHARACTER(10); 

DB_NAME2 CHARACTER(10); 

EXEC SQL END DECLARE SECTION; 


SET DB_NAME1 - 'PAYROLL' 
SET DB_NAME2 - 'MANAGERS' 


EXEC SQL AT :DB_NAME1 UPDATE... 

EXEC SQL AT :DB_NAME2 UPDATE... 

?=3j Additional Information: For more information on concurrent 
o~i c logons, see the section in the Programmer's Guide to Oracle 
Precompilers vl .5. 









Note: Applications using XA should not create Oracle Server 
database connections of their own. Any work performed by 
them would be outside the global transaction, and may confuse 
the connection information used by the Oracle XA library. 


Using OCIs with the Oracle XA Library 

OCI applications that use the Oracle XA library should not call olonO or 
orlonO to log on to the resource manager. Rather, the logon should be 
done through the TPM. The applications can execute the function 
sqlld2() to obtain the Ida structure they need to access the resource 
manager. 

Because an application server can have multiple concurrent open Oracle 
Server resource managers, it should call the function sqlld2() with the 
correct arguments to obtain the correct Ida structure. 

If DB =db_name is not present in the open string, then execute: 

sqlld2(lda, NULL, 0); 

to obtain the Ida for this resource manager. 

Alternatively, if DB =db_name is present in the open string, then execute: 

sqlld2(lda, db_nawe, strlen {db_name )); 

to obtain the Ida for this resource manager. 

Additional Information: For more information about using the 
o^iJ sqlld2() function, see the Programmer's Guide to the Oracle Call 
Interfaces. 


How to Use Transaction Control 

This section explains how to use transaction control within the Oracle 
XA library environment. 


When the XA library is used, transactions are not controlled by the SQL 
statements which commit or roll back transactions. Rather, they are 
controlled by an API accepted by the TM which starts and stops 
transactions. Most of the TMs use the TX interface for this. It includes 
the following functions: 


tx_open 

tx_close 

tx_begin 

tx_commit 


logs into the resource manager(s) 
logs out of the resource manager(s) 
starts a new transaction 
commits a transaction 
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tx_rollback rolls back the transaction 

Most TPM applications are written using a client-server architecture 
where an application client requests services and an application server 
provides services. The examples that follow use such a client-server 
model. A service is a logical unit of work, which in the case of the 
Oracle Server as the resource manager, comprises a set of SQL 
statements that perform a related unit of work. 

For example, when a service named "credit" receives an account 
number and the amount to be credited, it will execute SQL statements to 
update information in certain tables in the database. In addition, a 
service might request other services. For example, a "transfer fund" 
service might request services from a "credit" and "debit" service. 

Usually application clients request services from the application servers 
in order to perform tasks within a transaction. However, for some TPM 
systems, the application client itself can offer its own local services. 

You can encode transaction control statements within either the client or 
the server; as shown in the examples. 

In order to have more than one process participating in the same 
transaction, the TPM provides a communication API that allows 
transaction information to flow between the participating processes. 
Examples of communications APIs include RPC, pseudo-RPC functions, 
and send /receive functions. 

Because the leading vendors support different communication 
functions, the examples that follow use the communication 
pseudo-function tpm_service to generalize the communications API. 
X/Open has included several alternative methods for providing 
communication functions in their preliminary specification. At least one 
of these alternatives is supported by each of the leading TPM vendors. 

Examples of precompiler applications 

The following examples illustrate precompiler applications. Assume 
that the application servers have already logged onto the TPM system, 
in a TPM-specific manner. 

The first example shows a transaction started by an application server, 
and the second example shows a transaction started by an application 
client. 

Example 1: Transaction started by an application server. 

Client: 

tpm_service("ServiceName"); /* Request Service*/ 
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Server: 


ServiceName() 

{ 

<get service specific data> 

tx_begin(); /* Begin transaction boundary */ 

EXEC SQL UPDATE . . . . ; 

/*This application server temporarily becomes a client and 
requests *other service.*/ 

tpm_service("AnotherService"); 

tx_commit(); /* Commit the transaction */ 

creturn service status back to the client> 

} 

Example 2 Transaction started by an application client. 

Client: 

tx_begin(); /* 

tpm_service("Servicel"); 
tpm_service("Service2"); 
tx_commit(); 

Server: 

Servicel() 

{ 

<get service specific data> 

EXEC SQL UPDATE 

creturn service status back to the client> 

} 

Service2() 

{ 

<get service specific data> 

EXEC SQL UPDATE 

creturn service status back to client> 

} 

Migrating precompiler or OCI applications to TPM applications 

To migrate existing precompiler or OCI applications to a TPM 
application using the Oracle XA library, you must do the following: 

1. Reorganize the application into a framework of "services." 

This means that application clients request services from application 
servers. 


Begin transaction boundary */ 


/* Commit the transaction */ 
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Some TPMs require the application to use the tx_open and tx_close 
functions, whereas other TPMs do the logon and logoff implicitly. 

If you do not specify the sqlnet parameter in your open string, the 
application will use the default SQL*Net driver. On most UNIX 
systems, this is the IPC driver. Thus, you need to be sure that the 
application server is brought up with the ORACLE_HOME and 
ORACLEJ3ID environment variables properly defined. This is 
accomplished in a TPM-specific fashion. Refer to your TPM vendor 
documentation for instructions on how to accomplish this. 

2. Ensure that the application replaces the regular connect and 
disconnect statements. 

For example, replace the connect statements EXEC SQL CONNECT 
(for precompilers) or olon() (for OCIs) by tx_open(). Replace the 
disconnect statements EXEC SQL COMMIT/ROLLBACK RELEASE 
WORK (for precompilers), or ologofO (for OCIs) by tx_close(). 

3. Ensure that the application replaces the regular commit/rollback 
statements and begins the transaction explicitly. 

For example, replace the commit/rollback statements EXEC SQL 
COMMIT/ROLLBACK WORK (for precompilers), or ocom()/orol() 
(for OCIs) by tx_commit()/tx_rollback() and start the transaction by 
calling tx_begin(). 

4. Be sure to use release_cursor=yes, and to close all explicit cursors 
before committing a transaction. 
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The following table lists the TPM functions that replace regular Oracle 
commands when migrating precompiler or OCI applications to TPM 
applications. 


Regular Oracle Commands 

TPM Functions 

CONNECT user/password 

tx_open (possibly implicit) 

implicit start of transaction 

tx_begin 

SQL 

service that executes the SQL 

COMMIT 

tx_commit 

ROLLBACK 

tx_rollback 

disconnect 

tx_close (possibly implicit) 

SAVEPOINT savepoint 

illegal 

SET TRANSACTION READ ONLY 

illegal 


Table 6-1 TPM Replacement Commands 
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Troubleshooting 



This section discusses how to find information in case of problems or 
system failure. Both trace files and recovery of any pending transactions 
are discussed. 

Trace Files 

The Oracle XA library logs any error and tracing information to its trace 
file. This information is useful in supplementing the XA error codes. 

For example, it can indicate whether an xa_open failure is caused by an 
incorrect open string, failure to find the Oracle Server instance, or a 
login authorization failure. 

The name of the trace file is: 

xa_db_namedate. trc 

where db_name is the database name you specified in the open string 
field DB=db_name, and date is the date when the information is logged to 
the trace file. 

If you do not specify DB -dbjiame in the open string, it automatically 
defaults to the name "NULL". 

The trace file can be placed in one of the following locations: 

• The trace file can be created in the LogDir directory as specified 
in the open string. 

• If you do not specify LogDir in the open string, then the Oracle 

XA application attempts to create the trace file in the 
$ORACLE_HOME/rdbms/log directory, if it can determine 
where $ORACLE_HOME is located. 

• If the Oracle XA application cannot determine where 
$ORACLE_HOME is located, then the trace file is created in the 
current working directory. 

Trace file examples 

Examples of two types of trace files are discussed below. 

The example, xa_NULL040292.trc, shows a trace file that was created on 
April 2,1992. Its DB field was not specified in the open string when the 
resource manager was opened. 

The example, xa_Financel21591.trc, shows a trace file was created on 
December 15,1991. Its DB field was specified as "Finance" in the open 
string when the resource manager was opened. 
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Note that multiple Oracle XA library resource managers with the same 
DB field and LogDir field in their open strings log all trace information 
that occurs on the same day to the same trace file. 

Each entry in the trace file contains information that looks like this: 

1032.12345.2: xa_switch rtn ORA-22 

where "1032" is the time when the information is logged, "12345" is the 
process ID (PID), "2" is the resource manager ID, xa_switch is the 
module name, and ORA-22 is the Oracle Server information that was 
returned. 


In-doubt or Pending Transactions 

In-doubt or pending transactions are transactions that have been 
prepared, but not yet committed to the database. 

Generally, the transaction manager provided by the TPM system should 
resolve any failure and recovery of in-doubt or pending transactions. 
However, the DBA may have to override an in-doubt transaction in 
certain circumstances, such as when the in-doubt transaction is: 

• locking data that is required by other transactions 

• not resolved in a reasonable amount of time 

For more information about overriding in-doubt transactions in the 
circumstances described above, or about how to decide whether the 
in-doubt transaction should be committed or rolled back, refer to your 
TPM documentation. 

Additional Information: For more information on pending 
o^ie transactions, refer to the Oracle Concepts Manual . 

Oracle Server SYS account tables 

There are two tables under the Oracle Server SYS account that contain 
transactions generated by regular Oracle Server applications and Oracle 
XA applications. They are: 

• DBA_2PC_PENDING 

• DBA_2PC_NEIGHBORS 

DBA_2PC_NEIGHBORS 


For transactions generated by Oracle XA applications, the following 
column information applies specifically to the DBA_2PC_NEIGHBORS 
table. 
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• the DBID column is always xa_orcl 

• the DBUSER_OWNER column is always dbjiamex a.oracle.com 

Remember that the dbjname is always specified as Y)Y$=db_name in the 
open string. If you do not specify this field in the open string, then the 
value of this column is NULLxa.oracle.com for transactions generated 
by Oracle XA applications. 

For example, you could use the SQL statement below to obtain more 
information about in-doubt transactions generated by Oracle XA 
applications. 

SELECT * FROM DBA_2PC_PENDING p, DBA_2PC_NEIGHBORS n 
WHERE p.LOCAL_TRAN_ID = n.LOCAL_TRAN_ID 
AND 

n. DBID = 'xa__orcl'; 
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Restrictions 


General Restrictions 


General restrictions for the Oracle XA library are listed in this section. 


Database links 


Oracle XA applications can access other Oracle Server databases 
through database links, with the following restrictions: 

• Access to the other database must use SQL*Net v2. 

• The other database being accessed should be another Oracle 
Server database. 

Assuming that these restrictions are satisfied, Oracle Server will allow 
such links and will propagate the transaction protocol (prepare, rollback, 
and commit) to the other Oracle Server databases. 


Oracle Parallel Server option 



For Parallel Server: On some platforms, you cannot use the 
Oracle XA library together with the Oracle Parallel Server 
option. In order to run the Oracle XA library with the Parallel 
Server option, the platform's implementation of the distributed 
lock manager must support transaction-based rather than 
process-based deadlock detection. 



Additional Information: For more information about the 
Parallel Server and the Oracle XA library, see your ICG. 


SQL-based Restrictions 

SQL-based restrictions are listed in this section. 

Rollbacks and commits 

Because the transaction manager is responsible for coordinating and 
monitoring the progress of the transaction, the application should not 
contain any Oracle Server-specific statement that independently rolls 
back or commits a transaction. 

Do not use EXEC SQL ROLLBACK WORK for precompiler applications. 
Similarly, an OCI application should not execute orol(). You can roll 
back a transaction by the initiator by calling tx_rollback(). 
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Similarly, a precompiler application should not have the EXEC SQL 
COMMIT WORK statement. An OCI application should not execute 
ocom(). Instead, use tx_commit() or tx_rollback() to end a transaction. 

DDL statements 

Because a DDL SQL statement such as CREATE TABLE implies an 
implicit commit, the Oracle XA application cannot execute any DDL 
SQL statements. 

Savepoint 

Do not use savepoint. For example, do not use EXEC SQL SAVEPOINT 
savepointname. 

Read-only transactions 

Do not use read-only transactions. For example, do not execute SET 
TRANSACTION READ ONLY SQL statements. 

EXECSQL 

Do not use the EXEC SQL command to connect or disconnect. That is, 
do not use EXEC SQL COMMIT WORK RELEASE or EXEC SQL 
ROLLBACK WORK RELEASE. 
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CHAPTER 


UNIX Messages and 
Codes 



This chapter lists messages and codes specific to UNIX-based 
systems, along with possible causes and suggested actions. 

The topics covered in this chapter are: 

• using the oerr message help utility 

• using message number ranges 

. calling Oracle Worldwide Technical Support 
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Using the oerr Message Help Utility 

The Oracle utility oerr allows you to look up the text of messages, the 
possible causes of each error, and the action to be taken in the event of 
the error. To use oerr, ORACLEHOME must be set correctly. If you 
have purchased Multilingual Option, you can use the 
NLS_LANGUAGE environment variable to specify the language in 
which the information should be displayed. 

Use the following syntax to look up messages with oerr: 

oerr facility errno 

specifies a facility of the Oracle product to which the 
messages correspond. 

specifies the message number. 

some of the valid codes for facilities of Oracle 

Oracle Server 

imp Import 

exp Export 

dba SQL*DBA 

led Library Command Driver SQL*Forms: 

iap SQL*Forms Runform 

iad SQL*Forms Designer 

iac SQL*Forms Convert 

iag SQL*Forms Generate 

typ Type Conversions 

ifp SQL*Forms and PL/SQL integration 

(supported for SQL*Forms v3 only) 

Example For example, if you enter: 

$ oerr ora 7201 

the following information is displayed on your screen: 

07201, 00000, "slhom: oracle_home variable not set in 
environment." 

// *cause: $(ORACLE_HOME) environment variable not set. 

// *action: Set ORACLE_HOME. 


where: 

facility 

errno 

The following 
products: 

ora 
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The alert file logs more detailed information than the usual trace files, 
including the following unusual database occurrences. 

• instance startup and shutdown 

• messages to the operator console 

. errors that causes a trace file to be created 

. any CREATE, ALTER, or DROP operations issued on a database, 
tablespace, or rollback segment 

This file is located in the directory specified by the init.ora parameter 
background_dump_dest, whose default is 
$ORACLE_HOME/rdbms/log/alert_ORACLE_S/D.log 

Administer this file as other trace files. Because each new entry is added 
to the file, you need to clear it from time to time. 
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Using Message Number Ranges 

Oracle UNIX operating-system messages are grouped by type or cause 
into the number ranges listed below. You can use the number ranges to 
determine the type of error that has occurred. Text and explanation of 
each message are given in the following pages. 


Numbers 

Type of Error 

2700 - 2757 

UNIX Two-Task 

2758 - 2855 

SQL*Net Asynchronous 

2875 - 2893 

IBM RISC System/6000 AIX 

6000 - 6029 

SQL*Net ASYNC 

6030 - 6038 

SQL*Net DECnet Driver 

6107 - 6107 

SQL*Net TCP/IP Driver 

6220 - 6233 

SQL*Net Named Pipes Driver 

6400 - 6423 

SQL*Net Common 

6430 - 6457 

NCR System 3000 

6600 - 6622 

SQL*Net APPC/LU6.2 Driver 

6700 - 6817 

SQL*Net TLI Driver 

6970 - 6979 

SQIANet X.25 Driver 

7200 - 9961 

Operating System 

12221 -12599 

SQL*Net TNS 
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Calling Oracle Worldwide Technical Support 

Some messages recommend calling Oracle Worldwide Technical 
Support to report the error. When you call Worldwide Support, please 
have the following information at hand: 

1. The hardware, operating system, and release number of the 
operating system on which Oracle is running. 

2. The version number of the Oracle product. 

3. All Oracle programs (with version numbers) in use when the error 
occurred (SQL*Net vl.2, for example). 

4. The exact code(s) or messages, in the order they appear. 

5. The severity of the problem using the following codes: 

If you need a second paragraph to follow a numbered list item, use 
this num:l-level:para component. 

1= Program not usable. Critical impact on operations. 

2= Program usable. Operations severely restricted 

3= Program usable with limited functions. Not critical to overall 
operations. 

4= Program circumvented by customer. Minimal effect, if any, on 
operations. 

6. A description of the problem, including any unusual conditions. 
You will be expected to provide the following additional information: 

• name 

• company's name 

• company's Oracle Support ID Number 

• phone number 
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ORA-2700 

Cause 

Action 

ORA-2701 

Cause 

Action 

ORA-2702 

Cause 

Action 

ORA-2703 

Cause 

Action 

ORA-2704 

Cause 

Action 

ORA-2705 

Cause 

Action 

ORA-2706 

Cause 

Action 


Messages 

This section lists two-task driver messages, their probable causes and 
suggested actions. Messages for the BEQ Adapter may be found in the 
Oracle Network Products Messages Manual. 

osnoraenv: error translating ORACLE_SID 

Two-task driver could not find the value of ORACLE_SID in the environment. 

Make sure that the ORACLE SID environment variable has been properly set 
and exported. 

osnoraenv: error translating oracle image name 

ORACLE_HOME environment variable not set. 

Make sure that the ORACLE HOME environment variable has been properly 
set and exported. 

osnoraenv: error translating orapop image name 

ORACLEJHOME environment variable not set. 

Make sure that the ORACLE_HOME environment variable has been properly 
set and exported. 

osnpopipe: pipe creation failed 

The pipe driver failed to create pipes for communications with the orapop 
process. You have probably exceeded the maximum number of open file 
descriptors per user or the system file table is full. 

Note the operating system code and contact your system administrator.. 

osndopop: fork failed 

The two-task driver could not fork orapop. 

Verify that there are enough system resources to support another process. The 
user or system process limit may have been exceeded, or the amount of free 
memory or swap space may be temporarily insufficient. 

osnpol: polling of communication channel failed 

The pipe driver failed while polling the communications channel. 

Contact Oracle Worldwide Technical Support. 

osnshs: host name too long 

The length of your host-string specified by the TWO_TASK environment 
variable exceeds the Oracle system-imposed limit. 

Contact Oracle Worldwide Technical Support. 
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ORA-2707 

osnacx: cannot allocate context area 

Cause 

The invoked UNIX two-task driver could not allocate heap space for the context 
area. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-2708 

osnrntab: connect to host failed, unknown ORACLE_SID 

Cause 

The invoked two-task driver failed to find an entry in the /var/opt/oracle/oratab 
file for the sid you supplied. 

Action 

First, check whether you have read access to the /var/opt/oracle/oratab file, and 
see if the desired sid is there. Add an entry to oratab for the desired sid, if 
necessary. 

ORA-2709 

osnpop: pipe creation failed 

Cause 

The pipe driver failed to create pipes for two-task communications with the 
oracle shadow process. 

Action 

You have probably exceeded the maximum number of open file descriptors per 
user or the system file table is full. Note the operating system code and contact 
your system administrator. 

ORA-2710 

osnpop: fork failed 

Cause 

The pipe driver could not fork the oracle shadow process. 

Action 

Verify that there are enough system resources to support another process. The 
user or system process limit may have been exceeded, or the amount of free 
memory or swap space may be temporarily insufficient. 

ORA-2711 

osnpvalid: write to validation channel failed 

Cause 

The pipe driver failed to write to the orapop process. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-2712 

osnopp: malloc failed 

Cause 

The pipe driver failed to allocate enough heap space for its context area buffers. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-2713 

osnprd: message receive failure 

Cause 

The pipe driver failed to write a message to the communications channel. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-2714 

osnpwr: message send failure 

Cause 

The pipe driver failed to write a message to the communications channel. 

Action 

Contact Oracle Worldwide Technical Support. 
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ORA-2715 

osnpgetbrkmsg: message from host had incorrect message type 

Cause 

The pipe driver received a message with an unrecognizable message type. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-2716 

osnpgetdatmsg: message from host had incorrect message type 

Cause 

The pipe driver received a message with an unrecognizable message type. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-2717 

osnpfs: incorrect number of bytes written 

Cause 

The pipe driver sent a message that was apparently successful, but the number 
of bytes transmitted did not match the number of bytes furnished to the driver. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-2718 

osnprs: reset protocol error 

Cause 

The two-task driver could not reset the connection. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-2719 

osnfop: fork failed 

Cause 

The Fast driver could not fork the Oracle shadow process. 

Action 

Verify that there are enough system resources to support another process. The 
user or system process limit may have been exceeded, or the free memory or 
swap space may be temporarily insufficient. 

ORA-2720 

osnfop: shmat failed 

Cause 

When the Fast driver was invoked, processes failed to attach to the shared 
memory buffer. You probably supplied an illegal shared memory attach 
address, or the system ran out of data space for the buffer. 

Action 

Try invoking the Fast driver later, or use the default attack address. 

ORA-2721 

osnseminit: cannot create semaphore set 

Cause 

The Fast driver failed to get a semaphore set. 

Action 

The system-imposed limit on semaphores or semaphore identifiers may have 
been exceeded. Read the returned operating system code and consult your 
system administrator. 

ORA-2722 

osnpui: cannot send break message to orapop 

Cause 

The pipe driver could not send a break message to orapop. 

Action 

Contact Oracle Worldwide Technical Support. 
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ORA-2723 

Cause 

Action 

ORA-2724 

Cause 

Action 

ORA-2725 

Cause 

Action 

ORA-2726 

Cause 

Action 

ORA-2727 

Cause 

Action 

ORA-2728 

Cause 

Action 

ORA-2729 

Cause 

Action 

ORA-2730 

Cause 

Action 


osnpui: cannot send break signal 

The pipe driver could not send a break message to the oracle shadow process. 
Contact Oracle Worldwide Technical Support. 

osnpbr: cannot send break signal 

The pipe driver could not send a break message to orapop. 

Contact Oracle Worldwide Technical Support. 

osnpbr: cannot send break signal 

The pipe driver could not send a break message to the oracle shadow process. 

Contact Oracle Worldwide Technical Support. 

osnpop: access error on oracle executable 

The pipe driver could not access the oracle executable. 

Check the permissions on the oracle executable and each component of the 

ORACLE_HOME/bin path. 

osnpop: access error on orapop executable 

The pipe driver could not access the orapop executable. 

Check the permissions on the orapop executable and each component of the 
ORACLE_HOME/bin path. 

osnfop: access error on oracle executable 

The Fast driver could not access the oracle executable. 

Check the permissions on the Oracle executable and each component of the 

ORACLE_HOME/bin path. 

osncon: driver not in osntab 

The driver you specified is not supported. 

Consult with your database administrator for supported drivers. 

osnrnf: cannot find user logon directory 

The driver you have specified could not find your logon directory while 
searching for your local .tnsnames.ora file. 

Set and export the ORACLE_HOME environment variable to identify your 
home directory. Check with your system administrator to make sure that your 
user ID and home directory are correct in the /etc/passwd file. 
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ORA-2731 

osnrnf: malloc of buffer failed 

Cause 

The specified driver could not find enough heap space to malloc a buffer. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-2732 

osnrnf: cannot find a matching database alias 

Cause 

Database alias specified was not identified in either $HOME/.tnsnames.ora or 
/var/opt/oracle./tnsnames.ora. 

Action 

Create the alias in a file called .tnsnames.ora in your home directory for 
personal use or ask your system administrator to create the alias in 
/var/opt/oracle./tnsnames.ora for system-wide use. 

ORA-2733 

osnsnf: database string too long 

Cause 

While converting a database alias to an ORACLE_SID, the resulting 
ORACLE_SID string exceeded the Oracle system-imposed limit. 

ORA-2734 

osnftt: cannot reset shared memory permission 

Cause 

The Fast driver was unable to reset shared memory permissions. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-2735 

osnfpm: cannot create shared memory segment for two-task communication 

Cause 

The Fast driver failed to create a shared memory segment for two-task 
communication. 

Action 

Check if the system-imposed limit on shared memory identifiers has been 
reached for your system. 

ORA-2736 

osnfpm: illegal default shared memory address 

Cause 

The Fast driver failed to establish a default shared memory address. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-2737 

osnpcl: cannot tell orapop to exit 

Cause 

The pipe driver failed to send orapop the command to exit. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-2738 

osnpwrtbrkmsg: incorrect number of bytes written 

Cause 

The pipe driver apparently sent an incomplete break message. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-2739 

osncon: host alias is too long 

Cause 

The alias used for a SQL*Net host is longer than 161 characters. 

Action 

Use a shorter alias. 
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ORA-2750 

osnfsmmap: cannot open shared memory file ?/dbs/ftt <pid>.dbf 

Cause 

The Fast driver failed to map a shared memory file for two-task communication. 

Action 

Check the permissions on the directory ?/dbs. 

ORA-2751 

osnfsmmap: cannot map shared memory file 

Cause 

The Fast driver failed to map a shared memory file for two-task communication. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-2752 

osnfsmmap: illegal shared memory address 

Cause 

The Fast driver failed to attach shared memory at the expected location. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-2753 

osnfsmmap: cannot close shared memory file 

Cause 

The Fast driver cannot close the shared memory file. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-2754 

osnfsmmap: cannot change shared memory inheritance 

Cause 

The Fast driver could not alter the inheritance attributes of the shared memory. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-2755 

osnfsmcre: cannot create shared memory file ?/dbs/ftt _pid.d bf 

Cause 

The Fast driver failed to create a file for shared memory. 

Action 

Check the permissions on the directory ?/dbs. 

ORA-2756 

osnfsmnam: name translation failure 

Cause 

The Fast driver encountered an error translating the shared memory filename 
?/dbs/ftt jpidA bf. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-2757 

osnfop: fork_and_bind failed 

Cause 

The Fast driver failed to fork a process onto the desired cluster and node 
number. 

Action 

Check the desired node number in sercose[0] and cluster ID in sercose[l]. If 
these seem valid, contact Oracle Worldwide Technical Support. 
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SQL*Net Asynchronous Messages 

ORA-2758 Allocation of internal array failed 


Cause 

The package was unable to allocate memory for an array because the system ran 
out of memory. 

Action 

Either reclaim memory by killing other processes or reboot the machine with 
more memory. 

ORA-2759 

Not enough request descriptors available 

Cause 

All the packages' requests are in use performing other requests. 

Action 

Either wait until enough requests are done, or shut the package down and 
re-initialize it with more request descriptors. 

ORA-2760 

Client close of file failed 

Cause 

The client was unable to close a file after forking the servers. 

Action 

This is a system problem. Contact your system administrator. 

ORA-2761 

File number to be cancelled is negative 

Cause 

The file contained with the sfiov structure is less than zero. 

Action 

This may be a programming error. If it is not, contact Oracle Worldwide 
Technical Support. 

ORA-2762 

File number to cancelled is greater than the maximum 

Cause 

The file number contained with the sfioc structure is greater than the maximum. 

Action 

This may be a programming error. If it is not, contact Oracle Worldwide 
Technical Support. 

ORA-2763 

Unable to cancel at least one request 

Cause 

No requests were found that could be cancelled. 

Action 

This error can occur if all the requests dealing with that file number have already 
been filled. 

ORA-2764 

Invalid package mode 

Cause 

The mode of the package can only be parallel or duplex. 

Action 

See sfa.h for the correct values. 

ORA-2765 

Invalid maximum number of servers 

Cause 

The number of servers given was less than or equal to zero. 

Action 

Use a number greater than zero. 
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ORA-2766 

Invalid maximum of request descriptors 

Cause 

The number of request descriptors was less than or equal to zero. 

Action 

Use a number greater than zero. 

ORA-2767 

Less than one request descriptor was allocated per server. 

Cause 

The package requires that the number of request descriptors be greater than or 
equal to the number of servers used. 

Action 

Use a higher number. 

ORA-2768 

Maximum number of files is invalid 

Cause 

The maximum number of files to be used by the package was less than or equal 
to zero. 

Action 

Use a positive number. 

ORA-2769 

Setting of handler for SIGTERM failed. 

Cause 

The package was unable to set up handling by the server for the termination 
signal. This is an internal error. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-2770 

Total number of blocks is invalid 

Cause 

The total number of blocks to be allocated for use by the package was not greater 
than zero. 

Action 

Use a positive number. 

ORA-2771 

Illegal request time out value 

Cause 

The number was not a positive number. 

Action 

Use a positive number. 

ORA-2772 

Invalid maximum server idle time 

Cause 

The time given was not a positive number 

Action 

Use a positive number. 

ORA-2773 

Invalid maximum client wait time 

Cause 

The time given was not a positive number. 

Action 

Use a positive number. 

ORA-2774 

Invalid request list latch time out value 

Cause 

The time given was not a positive number. 

Action 

Use a positive number. 
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ORA-2775 

Invalid request done signal exceeds maximum 

Cause 

The signal number was not a positive number. 

Action 

Use a positive number. 

ORA-2776 

Value for request done signal exceeds maximum 

Cause 

The value sent to the package for use as the "request done" signal exceeds the 
maximum allowed by the operating system. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-2777 

Stat failed on log directory 

Cause 

The package was unable to get information about the directory in which the log 
files are to reside. 

Action 

Check the permissions on the directory or use a different directory name. 

ORA-2778 

Name given for the log directory in invalid 

Cause 

The name given for the directory in which the logs are to be kept does not 
correspond to a directory. 

Action 

Use a different name. 

ORA-2779 

Stat failed on core dump directory. 

Cause 

The package was unable to get information about the directory into which the 
servers are to dump core in the event of an exception. 

Action 

Check the permissions on the directory or use a different directory name. 

ORA-2780 

Name given for the core dump directory is invalid 

Cause 

The name given for the directory in which the server processes are to dump core 
in the event of an exception does not correspond to a directory. 

Action 

Use a different name. 

ORA-2781 

Invalid value given for the timing wanted flag 

Cause 

The value given was not TRUE or FALSE. 

Action 

Use a different value. 

ORA-2782 

Both read and write functions were not specified 

Cause 

To ensure that the functions act symmetrically, pointers to both the read and 
write functions must be given. 

Action 

Either specify both functions or specify neither. The package will supply its own 
functions. 
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ORA-2783 

Both post and wait functions were not specified. 

Cause 

To ensure that the functions act symmetrically, pointers to both the posting and 
waiting functions must be given. 

Action 

Either specify both functions or specify neither. The package will supply its own 
functions. 

ORA-2784 

Invalid shared memory ID specified 

Cause 

The ID of the segment specified for use as the shared buffer region was invalid. 

Action 

Use a different ID, or let the package specify its own. 

ORA-2785 

Invalid shared memory buffer size 

Cause 

The size given for the shared memory segment to be used as the shared buffer 
region was less than or equal to zero. 

Action 

Use a positive number. 

ORA-2786 

Size needed for shared region is greater than segment size 

Cause 

The size of the shared segment that was specified for the shared buffer region is 
less than the number of bytes required. The first field of the additional 
information field is the size needed. The second is the size of the segment. 

Action 

Use a larger segment or let the package allocate its own. 

ORA-2787 

Unable to allocate memory for segment list 

Cause 

The package cannot allocate memory for an internal segment list because the 
system has run out of memory. The additional information field is the amount 
of memory that the package attempted to allocate. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-2788 

Unable to find kernel process pointer in async process array 

Cause 

Internal error. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-2789 

Maximum number of files reached 

Cause 

The maximum number of files that can be used for asynchronous I/O has been 
reached. 

Action 

Shut down the servers and re-initialize the package with a higher number. 

ORA-2790 

File name is too long 

Cause 

The length of the name of a file that is being opened for asynchronous 1/O is 
longer than the maximum. The additional information field is the maximum 
length. 

Action 

Use a shorter name. 
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ORA-2791 

Unable to open file for use with asynchronous I/O 

Cause 

The package could not open file for some reason. 

Action 

Check the file name. 

ORA-2792 

Unable to fstat () a file being used for asynchronous I/O 

Cause 

The fstat (2) call on a file being used for asynchronous I/O failed. 

Action 

Check the file name. 

ORA-2793 

Close of asynchronous I/O failed 

Cause 

The client was unable to close a file being used for asynchronous I/O. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-2794 

Client unable to get key for shared memory 

Cause 

The client was unable to get a key so that it could obtain use of shared memory. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-2795 

Request list is empty 

Cause 

The client was signalled by a server that it was done with a request but the 
"done" list was empty. 

Action 

Internal error - contact Oracle Worldwide Technical Support. 

ORA-2796 

Done request is not in correct state 

Cause 

A request is not in the right state. 

Action 

Internal error - contact Oracle Worldwide Technical Support. 

ORA-2797 

No requests available 

Cause 

No free request descriptors are available. 

Action 

Wait until some requests are filled and then retry the request, or shut down the 
servers and initialize the package with a higher number of requests. 

ORA-2798 

Invalid number of requests 

Cause 

The number of operations sent to either sfard() or sfawriteO is less than zero. 

Action 

This is a user programming error. 

ORA-2799 

Unable to arm signal handler 

Cause 

The arming of a signal handler for the "done" signal failed. 

Action 

Internal error - contact Oracle Worldwide Technical Support. 
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ORA-2800 

Requests timed out 

Cause 

Some of the requests for asynchronous input or output were not serviced in the 
required amount of time. 

Action 

If the load on the system is high, it is possible that the timeout limit is too low. 
Reset it with sfainit(). If the server processes are dying due to unexpected 
signals, this is an internal error, and you should contact Oracle Worldwide 
Technical Support. 

ORA-2801 

Operations timed out 

Cause 

Some asynchronous operations timed out in kernel mode. 

Action 

Internal error - contact Oracle Worldwide Technical Support. 

ORA-2802 

No idle servers available in parallel mode 

Cause 

Internal error. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-2803 

Retrieval of current time failed 

Cause 

Internal error. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-2804 

Allocation of memory failed for log file name 

Cause 

The client was unable to allocate a buffer for the name of the log file. 

Action 

Contact your system administrator. 

ORA-2805 

Unable to set handler for SIGTPA 

Cause 

Internal error. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-2806 

Unable to set handler for SIGALRM 

Cause 

Internal error. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-2807 

Allocation of memory for I/O vectors failed. 

Cause 

The client was unable to allocate memory for the array of I/O vectors that the 
servers are to use. 

Action 

Contact your system administrator. 
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ORA-2808 

Allocation of memory of open files array failed. 

Cause 

The client was unable to allocate memory for an array of flags that the servers 
are to use. 

Action 

Contact your system administrator. 

ORA-2809 

Jump buffer not valid 

Cause 

Internal error. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-2813 

Unable to make temporary file name in order to get key 

Cause 

Internal error. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-2814 

Unable to get shared memory 

Cause 

Shmget(2) failed. 

Action 

Check the UNIX number. If you are unsure about what it means, contact Oracle 
Worldwide Technical Support. 

ORA-2815 

Unable to attach shared memory. 

Cause 

Shmat(2) failed. 

Action 

Check the UNIX number. If you are unsure about what it means, contact Oracle 
Worldwide Technical Support. 

ORA-2816 

Unable to kill a process 

Cause 

A server did not die after being sent a kill signal. 

Action 

The process may be a runaway - contact Oracle Worldwide Technical Support. 

ORA-2817 

Read failed 

Cause 

A server could not read a requested amount of data. 

Action 

Check the call to sfard(). An incorrect file descriptor may have been sent to 
sfardO. The number in the "additional information" field is the starting block 
number of the data segment being read in. 

ORA-2818 

Less than the number of blocks requested was read in 

Cause 

A server could not read in the requested amount of data. The first number in the 
"additional information" field is the block number being read in. The second is 
the actual number of bytes that was read in. 

Action 

This is a programming error. 
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ORA-2819 

Cause 


Action 

ORA-2820 

Cause 

Action 

ORA-2821 

Cause 

Action 

ORA-2822 

Cause 

Action 

ORA-2823 

Cause 

Action 

ORA-2824 

Cause 

Action 

ORA-2825 

Cause 

Action 

ORA-2826 

Cause 

Action 


Write failed 

A server was unable to perform a write. The number in the "additional 
information" field is the starting block number of the data segment being 
written out. The first number in the "additional information" field is the block 
number being written out. The second is the actual number of bytes that was 
written out. The disk may have filled up. 

Check the UNIX number. 

Unable to write the requested number of blocks 

A server could not write the requested amount of data out to disk. The disk 
may have run out of space. 

Check the UNIX number. 

Unable to read the requested number of blocks. 

A server could not read the number of blocks requested. The end of the file may 
have been read. 

Check the file on disk. 

Invalid block offset. 

A server was unable to seek to the designated block. 

Check the UNIX number. 

Buffer is not aligned. 

The buffer on which an I/O is being done is not on the correct boundary. 

Check the calling program. 

Request free list is empty 

The list from which the package allocates request descriptors is empty because 
all the descriptors are in use. 

Wait until some become free, or initialize the package with a higher number of 
request descriptors. 

Request on free list was not free 

Internal error. 

Contact Oracle Worldwide Technical Support. 

Illegal block size 

A negative number was given for the I/O block size to be used by the 
asynchronous I/O package. 

This is a programming error - use either a positive number or zero to get the 
default value. 
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ORA-2827 

Cause 

Action 

ORA-2828 

Cause 

Action 

ORA-2829 

Cause 

Action 

ORA-2830 

Cause 

Action 

ORA-2831 

Cause 

Action 

ORA-2832 

Cause 

Action 

ORA-2833 

Cause 

Action 

ORA-2834 

Cause 

Action 

ORA-2835 

Cause 

Action 


Invalid file number 

The file number upon which an operation is done is either less than zero or 
greater than the maximum number of files than can be open. 

This is a programming error. The calling program should not touch this number. 

Segment free list is empty 

No segments are available to be allocated. 

Free some segments or shut down the package and re-initialize it with a higher 
number of segments. 

No segment of the proper size is available 

No segment of the proper size is ready for use by the caller. 

Free some segments and try again. 

Segment could not be split - no free segments available 

A segment that is larger than that desired could not be split because no free 
segment was available. 

Free some segments and try again. 

Segment deallocation failed - empty segment list 

The caller attempted to de-allocate a segment but the "in use" list was empty. 
This is a programming error. 

Check the calling program. 

Segment deallocation failed - segment not on list 

The caller attempted to de-allocate a segment that was not on the "in use" list. 
This is a programming error. 

Check the calling program. 

Server was unable to close file 

A server was unable to close a file being used for asynchronous I/O. 

See the UNIX number for more information. 

Server unable to open file 

The server was unable to open a file for use with asynchronous I/O. 

Check the UNIX number for more information. 

Server unable to send signal to client 

Internal error. 

Contact Oracle Worldwide Technical Support. 
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ORA-2836 

Unable to create temporary key file 

Cause 

Internal error. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-2837 

Unable to unlink temporary file 

Cause 

Internal error. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-2838 

Unable to arm signal handler for the alarm signal 

Cause 

The arming of a signal handler for the alarm signal failed. 

Action 

Internal error - contact Oracle Worldwide Technical Support. 

ORA-2839 

Sync of blocks to disk failed. 

Cause 

The server was unable to flush its writes out to disk. 

Action 

Check the UNIX number. 

ORA-2840 

Open of log file by client failed. 

Cause 

The client process was unable to open its log file. 

Action 

Check the UNIX number for more information. 

ORA-2841 

Server died on start up. 

Cause 

A server exited during its initialization process. 

Action 

Check the servers' logs for more information. 

ORA-2842 

Client unable to fork a server. 

Cause 

The client could not spawn a server. A possible reason is that the operating 
system has reached its limit on the number of processes it can spawn. 

Action 

Either reduce the number of servers to be used, or reconfigure the operating 
system so that it can handle more processes. 

ORA-2843 

Invalid value for kernel flag. 

Cause 

An illegal value was given for the kernel flag in the information structure. Only 
TRUE and FALSE are permitted. 

Action 

This is a programming error - check the calling routine. 

ORA-2844 

Invalid value for the leave open flag. 

Cause 

A value was given for the flag that determines whether a file is to be left open 
after the client checks it to see if the servers can use it. Only TRUE and FALSE 
are supported. 

Action 

This is a programming error - check the calling routine. 
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ORA-2845 

Invalid value for the timing wanted flag. 

Cause 

A value was given for the flag that indicates that operations are to be timed out. 
Only TRUE and FALSE are supported. 

Action 

This is a programming error - check the calling routine. 

ORA-2846 

Unkillable server. 

Cause 

A server would not respond to the termination signal. The first number is the 
number of the server. The second is its UNIX process number. This is an 
internal problem. 

Action 

This is an operating system problem. 

ORA-2847 

Server did not terminate when posted. 

Cause 

A server did not respond to a posted request to shutdown. The first number is 
the number of the server. The second is its UNIX process number. This is an 
internal problem. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-2848 

Asynchronous I/O package is not running. 

Cause 

An operation using the asynchronous I/O package was attempted without first 
initializing the package using sfainit(). 

Action 

Call sfainitO before using the package. 

ORA-2849 

Read failed because of an error. 

Cause 

A server could not read the requested amount of data from disk. 

Action 

Check the UNIX number. 

ORA-2850 

File is closed. 

Cause 

A file upon which an asynchronous I/O operation is to be performed has 
already been closed by the package. 

Action 

This is a programming error. 

ORA-2851 

Request list is empty when it should not be. 

Cause 

This is an internal problem. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-2852 

Invalid critical-section time out value. 

Cause 

The time given was not a positive number. 

Action 

Use a positive number. 
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ORA-2853 

Invalid server list latch time out value. 

Cause 

The time given was not a positive number. 

Action 

Use a positive number. 

ORA-2854 

Invalid number of request buffers. 

Cause 

The value given for db_slave_buffers in your init.ora file is less than 0. 

Action 

Use a number that is greater than or equal to 0. 

ORA-2855 

Number of requests is less than the number of slaves. 

Cause 

The value given for db_slave_buffers in your init.ora file is less than the number 
specified for the number of slaves, db_slaves. 

Action 

Specify a number that is greater than that given for db_slaves. Alternatively, 
specify 0. The kernel will supply the appropriate number. 


UNIX Messages and Codes 


7-23 









IBM RISC System/6000 AIX Messages 

ORA-2875 smpini: Unable to get shared memory for PGA 
Cause Stated in errno. 

Action Resolve the problem. 

ORA-2876 smpini: Unable to attach to shared memory for PGA 
Cause Stated in errno. 

Action Resolve the problem. 

ORA “2877 smpini: Unable to initialize memory protection 
Cause The adscpinit program has not been executed. 

Action Execute the adscpinit program as shown in your ICG . If the problem persists, 
try rebooting your computer. 

ORA-2878 sou2o: Variable smpdidini overwritten 


Cause 

Action 


ORA-2879 

Cause 

Action 

ORA-2880 

Cause 

Action 

ORA-2881 

Cause 

Action 

ORA-2882 

Cause 

Action 


The variable smpdidini was overwritten, probably by client code. 

Verify client code, for example, Pro*C, for illegal memory access. If the problem 
occurs outside Single-Task operation, contact Oracle Worldwide Technical 
Support. 

sou2o: Could not gain access to protected memory 

This is an internal error, note code in errno. 

Report to Oracle Worldwide Technical Support. Restarting your application or 
your computer may cure the problem. 

smpini: Could not register PGA for protection 

This is an internal error, note code in errno. 

Report to Oracle Worldwide Technical Support. Restarting your application or 
your computer may cure the problem. 

sou2o: Could not revoke access to protected memory 

This is an internal error, note code in errno. 

Report to Oracle Worldwide Technical Support. Restarting your application or 
your computer may cure the problem. 

sou2o: Could not register SGA for protection 

This is an internal error, note code in errno. 

Report to Oracle Worldwide Technical Support. Restarting your application or 
your computer may cure the problem. 
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ORA-2883 

sfofi: open error, unable to open database file for reading. 

Cause 

Open system call returned an error. 

Action 

Check errno. Verify existence, and permissions on database files. 

ORA-2884 

sfwfb: Could not close database file opened readonly 

Cause 

Close system call returned an error. This is an internal error. 

Action 

Report to Oracle Worldwide Technical Support. 

ORA-2885 

sfwfb: Could not reopen database file for reading and writing 

Cause 

Open system call returned an error. 

Action 

Check errno. Verify existence, and permissions on database files. 

ORA-2886 

sfwfb: Could not close database file opened read/write 

Cause 

Close system call returned an error. This is an internal error. 

Action 

Report to Oracle Worldwide Technical Support. 

ORA-2887 

sfwfb: Could not reopen database file readonly 

Cause 

Open system call returned an error. This is an internal error. 

Action 

Report to Oracle Worldwide Technical Support. 

ORA-2888 

ssaiorwb: Invalid file handle: seals do not match 

Cause 

An invalid argument was given to ssaiorwb. 

Action 

Report to Oracle Worldwide Technical Support. 

ORA-2889 

ssaiorwb: Invalid block number 

Cause 

The block number requested was out of bounds for the file. Additional 
information indicates block number. 

Action 

Verify block number. 

ORA-2890 

ssaiorwb: I/O failed because buffer was not aligned properly. 

Cause 

The i/o buffer was not aligned to the correct boundary. 

Action 

Internal error. Keep the trace file and contact Oracle Worldwide Technical 
Support. 

ORA-2891 

ssaiorwb: An async I/O request returned an error 


Cause One (or more) of the the async I/O requests that were processed by lio_listio 
returned an error code. The trace file will contain more information. 

Action Inspect the trace file, and verify that the data file is accessible. 
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ORA-2892 

Cause 

Action 

ORA-2893 

Cause 

Action 


ssaiorwb: I/O returned incorrect number of bytes. 

Possible truncated I/O of database file. Additional information returns block 
number and actual number of bytes read. 

Check block number and number of bytes read. 

ssaiorwb: lio_listio failed 

The lio_listio system call failed. 

Check errno and report to Oracle Worldwide Technical Support. 
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SQL*Net ASYNC Messages 

This section lists and describes the messages which you may see when 
using SQL*Net ASYNC. Note that in many cases, you are advised in the 
"Action" section of the message description to check the log file. This is 
the file $ORACLE_HOME/async/log/asyncsrv.log. 


ORA-6000 

NETASY: port open failure 

Cause 

Autologin unable to open port. 

Action 

Check log file for operating-system specific code. 

ORA-6001 

NETASY: port set-up failure 

Cause 

Autologin unable to change port attributes. 

Action 

Check log file for operating-system specific code. 

ORA-6002 

NETASY: port read failure 

Cause 

Autologin unable to read from port. 

Action 

Check log file for operating-system specific code. 

ORA-6003 

NETASY: port write failure 

Cause 

Autologin unable to write to port. 

Action 

Check log file for operating-system specific code. 

ORA-6004 

NETASY: dialog file open failure 

Cause 

Autologin unable to open dialog file. 

Action 

Check connect string for typing errors. 

ORA-6005 

NETASY: dialog file read failure 

Cause 

Autologin unable to read dialog file. 

Action 

Check log file for operating-system specific code. 

ORA-6006 

NETASY: dialog execute failure 

Cause 

Expected response never received. 

Action 

Close connection and retry. 

ORA-6007 

NETASY: bad dialog format 

Cause 

Dialog file contains syntax error. 

Action 

Correct the dialog file. 
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ORA-6009 NETASY: dialog filename too long 

Cause Full file spec for dialog file exceeds 64 bytes. 
Action Amend connect string accordingly. 

ORA-6010 NETASY: dialog file too long 

Cause Dialog file exceeds 768 bytes in length. 


Action 

Simplify dialog (for example, remove comments and redundant white space), or 
split into two and link with the more command. 

ORA-6011 

NETASY: dialog too long 

Cause 

One of two: dialog contains more than 24 exchange blocks; or dialog send string 
exceeds 84 bytes in length. 

Action 

ORA-6017 

Simplify dialog or split into two and link with more command. 

NETASY: message receive failure 

Cause 

ASYNC driver gets I/O error while doing network read operation. 

Action 

Check log file for operating-system specific code and contact Oracle Worldwide 
Technical Support. 

ORA-6018 

NETASY: message send failure 

Cause 

ASYNC driver gets I/O error while doing network write operation. 

Action 

Check log file for-system specific code and contact Oracle Worldwide Technical 
Support. 

ORA-6019 

NETASY: invalid login (connect) string 

Cause 

Syntax error in login string. 

Action 

ORA-6020 

Resubmit with correct string. 

NETASY: initialization failure 

Cause 

ASYNC driver unable to complete initialization. 

Action 

Check log file for operating-system specific code. 

ORA-6021 

NETASY: connect failed 

Cause 

ASYNC driver unable to establish connection with partner. 

Action 

Check log file for operating-system specific code. 

ORA-6022 

NETASY: channel open failure 

Cause 

No free channel. 

Action 

Contact Oracle Worldwide Technical Support. 
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ORA-6023 

Cause 

Action 

ORA-6024 

Cause 

Action 

ORA-6025 

Cause 

Action 

ORA-6026 

Cause 

Action 

ORA-6027 

Cause 

Action 

ORA-6028 

Cause 

Action 

ORA-6029 

Cause 

Action 


NETASY: port open failure 

ASYNC driver unable to open port. 

Check log file for operating-system specific code. 

NETASY: VTM error 

Virtual Terminal Manager unable to read /write to port. 

Check log file for operating-system specific code. 

NETASY: Configuration error 

ASYNC driver generated for server-only, but client service requested. 
Contact Oracle Worldwide Technical Support. 

NETASY: port close failure 
ASYNC driver unable to close port. 

Check log file for operating-system specific code. 

NETASY: channel close failure 
ASYNC driver unable to close channel. 

Check log file for operating-system specific code. 

NETASY: unable to initialize for logging 
ASYNC driver unable to initialize for logging 1/O. 

Contact Oracle Worldwide Technical Support. 

NETASY: port assignment failure 
ASYNC driver unable to assign port to channel 
Contact Oracle Worldwide Technical Support. 
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SQL*Net DECnet Driver Messages 

This section lists the messages you may receive while using SQL*Net 
DECnet. If you receive a message, check to see if it might be due to one 
of the following general situations: 

• The remote node may not be known to your system (client 
systems only). Run the DECnet Network Control Program (NCP) 
to make sure the node is properly defined. 

• The remote node may be down. Check with your system 
administrator. 


ORA-6030 

Cause 

Action 


ORA-6031 

Cause 

Action 


ORA-6032 

Cause 

Action 

ORA-6033 

Cause 

Action 


• DECnet may be down. Check your communications software 
and hardware by using SET HOST nodename. 

• The remote Oracle database or the remote Oracle Server may be 
down. Check with your system administrator. 

• The specific database on the remote server may not be defined or 
available. Refer to the instructions in this guide for configuration 
information on your specific system server configuration. 
Otherwise, contact your system administrator. 

connect failed, unrecognized nodename 

The remote node (host) name is not known to your system. 

Check the node name for spelling errors. If the spelling is correct, make sure the 
node name for the remote node is in your local node's DECnet Network Control 
Program (NCP) database. 

NETDNT: connect failed, unrecognized object name 

The object (command file to be invoked at the remote node) does not exist in the 
remote login directory. 

Make sure the task name is specified correctly. If the object file does not exist in 
the remote login directory, have the system administrator for the remote node 
create it. 

connect failed, access control rejected 

Login was rejected at remote node. 

Make sure the operating system username and password specified in the node 
name string are specified correctly. 

connect failed, partner rejected connection 

The remote node rejected the connection request. 

Contact your system administrator. 
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ORA-6034 

Cause 

Action 

ORA-6035 

Cause 

Action 

ORA-6036 

Cause 

Action 

ORA-6037 

Cause 

Action 

ORA-6038 

Cause 

Action 


connect failed, partner exited unexpectedly. 

unxdsv could not be started or was terminated abnormally. 

Check the object file for correctness. Examine the DECnet log files at the remote 
node to see what errors have occurred. 

connect failed, insufficient resources 

The remote node is too busy to support another connection. 

Wait and try again later. Report frequent occurrences to your network 
administrator. 

connect failed, no response from object 

The connection request timed out, or the remote node is not responding to 
connection requests. 

Contact your system administrator. 

connect failed, node unreachable 
The remote node is unreachable. 

Contact your network administrator. 

connect failed, network driver not loaded 

The network device driver is not currently installed/running on the local node. 

If you are working on a PC, load DECnet-DOS or CommUnity-DOS. On other 
systems, contact your system administrator. 
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SQL*Net TCP/IP Driver Messages 

ORA-6107 NETCP: ORACLE network server not found 
Cause No entry in SERVICES file for Oracle server. 

Action Add orasrv entry to the TCP/IP SERVICES file, or to the YELLOW PAGES 
services listings. 
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SQL*Net Named Pipes Messages 

ORA-6220 Named Pipes Driver: Local use of pipe not supported 


Cause 

You are attempting to connect to your own computer. 

Action 

You must specify a legal remote system name. 

ORA-6221 

Named Pipes Driver: Failed to open Named Pipe. 

Cause 

The specified remote system has no SQL*Net Named Pipes server running. 

Action 

Start nmpsrv on the required remote system. 

ORA-6222 

Named Pipes Driver: Internal memory allocation error. 

Cause 

It was not possible to allocate more dynamic memory. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-6223 

Named Pipes Driver: Read Named Pipe returned an error status. 

Cause 

The remote SQL*Net Named Pipes server nmpsrv stopped. 

Action 

Check the remote LAN Manager and/or the nmpsrv process status. 

ORA-6224 

Named Pipes Driver: Write Named Pipe returned an error status. 

Cause 

The remote SQL*Net Named Pipes server nmpsrv stopped. 

Action 

Check the remote LAN Manager and/or the nmpsrv process status. 

ORA-6225 

Named Pipes Driver: Wrong packet type received. 

Cause 

You are trying to reach an incompatible SQL*Net Named Pipes server or the 
underlying network hardware/software is faulty. 

Action 

Check the network for possible errors. 

ORA-6226 

Named Pipes Driver: Wrong size of received message. 

Cause 

You are trying to reach an incompatible SQL*Net Named Pipes server or the 
remote server has prematurely terminated. 

Action 

Check the remote LAN Manager and/or the nmpsrv process status. 

ORA-6227 

Named Pipes Driver: Internal reset function failed. 

Cause 

The SQL*Net Named Pipes driver did not manage to reset/clear the 
communication line. 

Action 

Contact Oracle Worldwide Technical Support. 
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ORA-6228 

Cause 

Action 

ORA-6229 

Cause 

Action 

ORA-6230 

Cause 

Action 

ORA-6231 

Cause 

Action 

ORA-6232 

Cause 

Action 

ORA-6233 

Cause 

Action 


Named Pipes Driver: All Named Pipes channels are in use. 

There are no more free channel servers available from nmpsrv. 

Wait for a channel to become available. Your database administrator may 
configure nmpsrv with a higher channel capacity. 

Named Pipes Driver: Error accessing shared memory segment. 

The shared memory segment used by the SQL*Net Named Pipes server cannot 
be accessed. It may have been removed accidentally by the ipcrm command, or 
possibly the nmpsrv process has stopped. 

Stop and restart the remote SQL*Net Named Pipes server (nmpsrv). 

Named Pipes Driver: SQL*Net handshake error. 

You are trying to reach an incompatible SQL*Net Named Pipes server or the 
remote server has prematurely terminated. 

Check the remote LAN Manager and/or the nmpsrv process status. 

Named Pipes Driver: Error return from Named Pipes listen. 

The remote server has closed the Named Pipe you were trying to reach. Possibly 
the SQL*Net Named Pipes server nmpsrv has stopped. 

Check the remote LAN Manager and/or the nmpsrv process status. 

Named Pipes Driver: Error return from Make Named Pipe. 

The server process nmpsrv was not able to create the required Named Pipe(s). 

Check for root privileges on the nmpsrv executable and check if LAN Manager 
is operational. 6 

Named Pipes Driver: The server process nmpsrv is not running. 

The SQL*Net Named Pipes server process was not started. 

Start the server with the nmpctl start command. 
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SQL*Net Common Messages 

ORA-6400 NETCMN: No default host string specified 


Cause 

There was no default host string specified in the configuration and the user did 
not specify any explicit connect string. 

Action 

Either reconfigure the system specifying a default connect string or use an 
explicit connect string. 

ORA-6417 

slcpuc: error in getting number of cpus 

Cause 

Error in mpcntl system call 

Action 

Check the errno and contact your system administrator. 

ORA-6419 

NETCMN: server cannot start oracle 

Cause 

The remote server was unable to start an Oracle process on behalf of the client. 

Action 

Make sure that permissions on the remote Oracle program are correctly set. 
Contact your system administrator. 

ORA-6420 

NETCMN: SID lookup failure 

Cause 

From the remote host's server: the database SID, specified in the login (connect) 
string, was not recognized. 

Action 

Add the appropriate SID entry to the CONFIG.ORA or oratab file on the remote 
host. You may also need to restart the remote server. 

ORA-6421 

NETCMN: Error detected in the read-in data 

Cause 

Error found during recomputation of checksum or CRC. 

Action 

Possible hardware failures of communication nodes. Contact your system 
administrator immediately. 

ORA-6422 

NETCMN: Error in sending data 

Cause 

Unable to transmit data to remote host 

Action 

Try to reconnect to remote host. Contact your system administrator. 

ORA-6423 

NETCMN: Error in receiving data 

Cause 

Unable to receive data from remote host 

Action 

Try to reconnect to remote host. Contact your system administrator. 
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NCR System 3000 Messages 

ORA-6430 ssaio: seals do not match 


Cause 

A function was called with an invalid argument. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-6431 

ssaio: invalid block number 

Cause 

The file block number is out of range of the file. The additional information 
returns the block number. 

Action 

Verify that the block number is correct. Run dbfsize and check if the block 
number is in that range. Contact Oracle Worldwide Technical Support. 

ORA-6432 

ssaio: buffer not aligned 

Cause 

The I/O buffer was not aligned on a 2 Kb boundary. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-6433 

ssaio: LSEEK error, unable to seek to requested block 

Cause 

The additional information returns the block number 

Action 

Look up the additional information returned in your operating system reference 
manual. Verify that the block number is correct. 

ORA-6434 

ssaio: read error, unable to read requested block from database file. 

Cause 

The read system call returned an error. 

Action 

The additional information indicates the block number. Look up the additional 
information returned in your operating system manual. 

ORA-6435 

ssaio: write error, unable to write requested block to database file. 

Cause 

The write system call returned an error. 

Action 

The additional information indicates the block number. Look up the additional 
information returned in your operating system manual. 

ORA-6436 

ssaio: asynchronous I/O failed due to incorrect parameters 

Cause 

The Asynchronous I/O system call returned an error. 

Action 

The additional information indicates the block number. Look up the additional 
information returned in your operating system manual. 

ORA-6437 

ssaio: the asynchronous write was unable to write to the database file 

Cause 

The Asynchronous I/O system call returned an error. 

Action 

The additional information indicates the block number. Look up the additional 
information returned in your operating system manual. 
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ORA-6438 

ssaio: the asynchronous read was unable to read from the database file 

Cause 

The Asynchronous I/O system call returned an error. 

Action 

The additional information indicates the block number. Look up the additional 
information returned in your operating system manual. 

ORA-6439 

ssaio: the asynchronous write returned incorrect number of bytes 

Cause 

This write call may have been truncated. The additional information returns the 
block number and number of bytes. 

Action 

Verify that the block number and the number of bytes written are correct. 

ORA-6440 

ssaio: the asynchronous read returned incorrect number of bytes 

Cause 

This read call may have been truncated. The additional information returns the 
block number and number of bytes. 

Action 

Verify that the block number and the number of bytes read are correct. 

ORA-6441 

ssvwat: the ORACLE instance is aborted, no need to perform wait 

Cause 

The DBA probably did a shutdown abort and the Oracle instance was using the 
post/wait extension. 

Action 

Check with your DBA if indeed a shutdown abort was performed. 

ORA-6442 

ssvwatev: failed with unexpected error number 

Cause 

Some system problems may exists on your system, please check error logs. 

Action 

The additional information indicates the error number. Look up the additional 
information returned in your operating system manual. 

ORA-6443 

ssvpstev: incorrect parameter passed to function call 

Cause 

An invalid event ID is passed in to this routine. 

Action 

The additional information indicates the event ID. 

ORA-6444 

ssvpstev: failed with unexpected error number 

Cause 

Some system problems may exist on your system, please check error logs. 

Action 

The additional information indicates the number. Look up the additional 
information returned in your operating system manual. 

ORA-6445 

ssvpstevrg: incorrect parameters passed to function call 

Cause 

An invalid event ID, or the low and high event ID do not exist. 

Action 

The additional information indicates the number. It also contains the event id, 
low boundary and high boundary. 
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ORA-6446 

ssvpstevrg: failed with unexpected error number 

Cause 

Some system problems may exist on your system, please check error logs. 

Action 

The additional information indicates the number. Look up the additional 
information returned in your operating system manual. 

ORA-6447 

ssvpstp: incorrect parameter passed to function call 

Cause 

Invalid oracle process ID is passed in to this routine. 

Action 

The additional information indicates the process ID. 

ORA-6448 

ssvpstp: failed with unexpected error number 

Cause 

Some system problems may exists on your system, please check error logs. 

Action 

The additional information indicates the number. Look up the additional 
information returned in your operating system manual. 

ORA-6449 

The list IO or the sysvendor is not installed 

Cause 

Oracle tries to use the sysvendor interface (init.ora parameter 
use_sysvendor=true) but the UNIX kernel does not have the Oracle sysvendor 
interface linked in. 

Action 

Set use_sysvendor=false in init.ora, if you do not want to use this interface or 
link the UNIX kernel with this interface so that Oracle can use it. 

ORA-6450 

Fatal error in the wait operation of the post/wait extension 

Cause 

Post/wait Kernel extension may not be compatible with this version of Oracle or 
this version of the operating system. 

Action 

Set the init.ora parameter use_post_wait_extension to false and contact Oracle 

Worldwide Technical Support for further action. 

ORA-6451 

Fatal error in the post operation of the post/wait extension 

Cause 

Post/wait Kernel extension may not be compatible with this version of Oracle or 
this version of the operating system. 

Action 

Set the init.ora parameter use_post_wait_extension to false and contact Oracle 

Worldwide Technical Support for further action. 

ORA-6452 

Fatal error in the nap operation of the post/wait extension 

Cause 

Post/wait Kernel extension may not be compatible with this version of Oracle or 
this version of the operating system. 

Action 

Set the init.ora parameter use_post_wait_extension to false and contact Oracle 

Worldwide Technical Support for further action. 


7-38 Oracle7 for UNIX 







ORA-6453 

Fatal error during open_convert DLM operation 

Cause 

Fatal error in lockmanager. 

Action 

Contact Oracle Worldwide Technical Support, check additional information and 
check DLM log files (/usr/dlm/log) 

ORA-6454 

Fatal error during convert DLM operation 

Action 

Contact Oracle Worldwide Technical Support, check additional information and 
check DLM log files (/usr/dlm/log) 

ORA-6455 

Fatal error during close DLM operation 

Action 

Contact Oracle Worldwide Technical Support, check additional information and 
check DLM log files (/usr/dlm/log) 

ORA-6456 

Fatal error during cancel DLM operation 

Action 

Contact Oracle Worldwide Technical Support, check additional information and 
check DLM log files (/usr/dlm/log) 

ORA-6457 

Unexpected completion code from DLM 

Action 

Contact Oracle Worldwide Technical Support, check additional information and 
check DLM log files (/usr/dlm/log) 
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SQL*Net APPC/LU6.2 Driver Messages 

ORA-6600 LU6.2 Driver: SNA software is not loaded. 


Cause 

The SNA software is not running. 

Action 

Start the SNA software and try again. 

ORA-6601 

LU6.2 Driver: Invalid database id string. 

Cause 

The database string in the connect was invalid. 

Action 

Provide a valid database string, as defined in documentation. 

ORA-6602 

LU6.2 Driver: Error allocating context area. 

Cause 

The operating system was unable to allocate sufficient memory to the LU6.2 
driver for use as context area. 

Action 

Ensure that all operating system parameters are set at optimum value. If the 
problem persists, contact Oracle Worldwide Technical Support. 

ORA-6603 

LU6.2 Driver: Error allocating memory. 

Cause 

The operating system was unable to allocate sufficient memory to the LU6.2 
driver for use as buffers. 

Action 

Ensure that all operating system parameters are set at an optimum value. If the 
problem persists, contact Oracle Worldwide Technical Support. 

ORA-6604 

LU6.2 Driver: Unable to allocate session with remote LU. 

Cause 

Allocate system call failed. 

Action 

Ensure that the SNA software is running and that sessions are free. If this is the 
case, then check your SNA configuration data for errors. You may have entered 
an incorrect parameter. 

ORA-6605 

LU6.2 Driver: Unexpected line turnaround. 

Cause 

SNA software switched from send to receive unexpectedly. 

Action 

Check the SNA configuration data, particularly parameters associated with a 
session. 

ORA-6606 

LU6.2 Driver: Unexpected response from SNA. 

Cause 

A data control parameter returned an unexpected value. 

Action 

Attempt to reproduce the problem, debug and record the value of all parameters 
at the time of error. Ensure that the SNA Server is functioning correctly. If the 
problem persists, contact Oracle Worldwide Technical Support. 
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ORA-6607 

LU6.2 Driver: Reset occurred in send state. 

Cause 

Reset was initiated by the local side of the connection while in send state. This 
can occur because a reset or break is attempted during a dialogue. The error 
indicates that the SNA software of the local machine was unable to service the 
SQL*Net software correctly. 

Action 

Check the SNA Server LOG data for further information. 

ORA-6608 

LU6.2 Driver: Reset occurred in receive state. 

Cause 

Reset was initiated by the local side of the connection whilst in receive state. 
This can occur because a reset or break is attempted during a dialogue. The 
error indicates that the SNA software of the local machine was unable to service 
the SQL*Net software correctly. 

Action 

Check the SNA Server LOG data for further information. 

ORA-6610 

LU6.2 Driver: Failed during deallocation. 

Cause 

LU6.2 driver was unable to de-allocate gracefully. 

Action 

Check the reason for de-allocation. Consult the SNA LOG data. 

ORA-6611 

LU6.2 Driver: Request to send error 

Cause 

The SNA Server indicated that a Request to Send system call failed. 

Action 

Consult the SNA Server LOG file for further information. 

ORA-6612 

LU6.2 Driver: Send data error 

Cause 

The SNA Server indicated that a Send Data system call failed. 

Action 

Consult the SNA Server LOG file for further information. 

ORA-6613 

LU6.2 Driver: Receive and wait error 

Cause 

The SNA Server indicated that a Receive and Wait system call failed. 

Action 

Consult the SNA Server LOG file for further information. 

ORA-6614 

LU6.2 Driver: Receive Immediate error 

Cause 

The SNA Server indicated that a Receive Immediate system call failed. 

Action 

Consult the SNA Server LOG file for further information. 

ORA-6615 

LU6.2 Driver: Send error 

Cause 

The SNA Server indicated that a Send Error system call failed. 

Action 

Consult the SNA Server LOG file for further information. 


UNIX Messages and Codes 7-41 










ORA-6616 LU6.2 Driver: Attach to LU failed 

Cause The SQL*Net APPC/LU6.2 Driver was unable to attach to the local LU. 


Action 

Ensure that the SNA Server is running and that the LU6.2 software has been 
installed. Also check the configuration of the LU you are trying to attach to, and 
check that the name of the LU used in the connect string is correct. On NCR 
System 3000 systems, this error also occurs if the LU name you are trying to use 
is already in use by another user. 

ORA-6617 

LU6.2 Driver: Attach to PU failed 

Cause 

The SQL*Net APPC/LU6.2 Driver was unable to attach to the local PU. 

Action 

Ensure that the SNA Server is running. Check the configuration data for 
problems. Consult the documentation provided with your SNA Server software 
for troubleshooting instructions. 

ORA-6618 

LU6.2 Driver: Activation of subnetwork failed 

Cause 

The connection to the subnetwork that the SNA Server is attempting to use was 
not successful. 

Action 

Ensure that the correct subnetwork is being used and that the SNA Server 
configuration data is correct. 

ORA-6619 

LU6.2 Driver: Unable to activate remote partner 

Cause 

The SNA Server was unable to attach to the SQL*Net LU6.2 server process at the 
remote side. 

Action 

Check that the server process specified in the connect string is actually installed 
on the remote system, and that it resides in the directory searched by the SNA 
Server software. If you have not specified the name of the server process in the 
connect string, the LU62DRV process is, by default, started. In this case, check 
that this process is also correctly installed. 

ORA-6620 

LU6.2 Driver: Invalid remote partner 

Cause 

The partner specified in the connect string is not a valid partner for the SQL*Net 
APPC/LU6.2 driver. 

Action 

Re-enter the connect string, specifying a valid partner process. By default, this 
partner is the LU62DRV process. 

ORA-6621 

LU6.2 Driver: Allocation error 

Cause 

An unrecoverable error occurred during allocation of the connection between 
the local and remote systems. 

Action 

Check the SNA configuration for errors. 
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ORA-6622 

Cause 

Action 


LU6.2 Driver: Unable to attach to SNA Server 

The SQL*Net APPC/LU6.2 Driver could not establish a dialogue with the SNA 
Server software. 

Check that the SNA Server is running. If so, ensure that the connect string 
contains valid information that will allow the SQL*Net APPC/LU6.2 driver to 
establish a dialogue with the correct parameters. For example, check the 
connection profile name to ensure it is known by the SNA Server. 
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SQL*Net TLI Driver Messages 


ORA-6700 

Cause 

Action 

ORA-6701 

Cause 

Action 

ORA-6702 

Cause 

Action 

ORA-6703 

Cause 

Action 

ORA-6704 

Cause 

Action 

ORA-6705 

Cause 

Action 

ORA-6706 

Cause 

Action 


TLI Driver: incorrect message type from host 

SQL*Net received a message with an unrecognizable message type. 

Check the operating system error message or number supplied with this 
message and then contact Oracle Worldwide Technical Support. 

TLI Driver: incorrect number of bytes written 

SQL*Net sent a message that was apparently successful, but the number of bytes 
transmitted did not match the number of bytes supplied to the driver. 

Check the operating system error message or number supplied with this 
message and then contact Oracle Worldwide Technical Support. 

TLI Driver: cannot allocate context area 

SQL*Net could not allocate heap space for the context area. 

Check the operating system error message or number supplied with this 
message and then contact Oracle Worldwide Technical Support. 

TLI Driver: send break message failed 

SQL*Net failed to send a break message across the connection. 

Check the operating system error message or number supplied with this 
message and then contact Oracle Worldwide Technical Support. 

TLI Driver: receive break message failed 

SQL*Net failed to receive an expected break message. 

Check the operating system error message or number supplied with this 
message and then contact Oracle Worldwide Technical Support. 

TLI Driver: remote node is unknown 

SQL*Net could not find your remote host information. 

Make sure you specified the hostname correctly on the command line. (Check 
your capitalization and spelling.) For TCP/IP, if the remote host is undefined in 
the HOSTS file, ask your system administrator to add an entry for the desired 
host. 

TLI Driver: service not found 

SQL*Net could not find service information for the specified service name. 

If you specified the service name on the command line or with the environment 
variable TLI_SERVER, make sure you specified it correctly. Otherwise, the 
service name defaults to tcptlisrv. If the service name is not in the SERVICES 
file, ask your system administrator to add it. 
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ORA-6707 

TLI Driver: connection failed 

Cause 

SQL*Net failed to establish the connection to a SQL*Net TCP/IP server due to 
an error found by the remote server, which has supplied a string describing the 
remote error. 

Action 

See the "orasrv Messages" section of the SQL*Net TCP/IP User's Guide , for the 
specific cause and action. 

ORA-6708 

TLI Driver: message receive failure 

Cause 

SQL*Net found an error receiving a message from the communication channel. 

Action 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

ORA-6709 

TLI Driver: message send failure 

Cause 

SQL*Net found an error sending a message across the communication channel. 

Action 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

ORA-6710 

TLI Driver: send interrupt break message failed 

Cause 

SQL*Net failed to send a break message while handling an interrupt signal from 
the user. 

Action 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

ORA-6711 

TLI Driver: error on bind 

Cause 

SQL*Net failed to assign a network address to the communication channel. 

Action 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

ORA-6712 

TLI Driver: error on accept 

Cause 

SQL*Net failed to accept a connection request from the client. 

Action 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

ORA-6713 

TLI Driver: error on connect 

Cause 

SQL*Net failed to connect the client to the remote server. The network line to 
the remote host may be down. 

Action 

Use telnet network login programs to make sure the remote host is accessible. 
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ORA-6720 

TLI Driver: SID lookup failure 

Cause 

The database sid supplied in the database login string was not recognized by the 
remote host. 

Action 

Ask your system administrator to add the appropriate sid entry to your 
/var/opt/oracle/oratab file on the remote host. The spxutl command can be used 
to find out which sids are available on the remote host. 

ORA-6721 

TLI Driver: spurious client req 

Cause 

The remote SQL*Net server received an undefined request. 

Action 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

ORA-6722 

TLI Driver: connection setup failure 

Cause 

The remote SQL*Net server rejected the connection request, and the client was 
unable to retrieve a code or message. 

Action 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

ORA-6730 

TLI Driver: unable to open clone device 

Cause 

SQL*Net failed to open the Streams clone device associated with the transport 
provider. 

Action 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

ORA-6731 

TLI Driver: cannot alloc t_call 

Cause 

SQL*Net cannot allocate space for the client's connection information. 

Action 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

ORA-6732 

TLI Driver: cannot alloc t_discon 

Cause 

SQL*Net cannot allocate space for the client's disconnection information. 

Action 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

ORA-6733 

TLI Driver: failed to receive disconnect 

Cause 

SQL*Net failed to receive an expected disconnection message during connection 
release. 

Action 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 
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ORA-6734 

TLI Driver: cannot connect 

Cause 

SQL*Net failed to connect the client to the remote server. 

Action 

Check that the remote SQL*Net server is running the spxutl command. 

ORA-6735 

TLI Driver: client failed to close error conn 

Cause 

SQL*Net failed to properly close a connection after an error was received. 

Action 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

ORA-6736 

TLI Driver: server not running 

Cause 

SQL*Net timed out while attempting to connect to the remote SQL*Net server. 

Action 

Using the spxutl command, check that the remote SQL*Net server is running. If 
it is not, ask your system administrator to start it. 

ORA-6737 

TLI Driver: connection failed 

Cause 

SQL*Net could not establish a connection to the remote SQL*Net server. 

Action 

Using the spxutl command, check that the remote SQL*Net server is running. If 
it is not, ask your system administrator to start it. 

ORA-6741 

TLI Driver: unable to open protocol device 

Cause 

The SQL*Net server failed to open the Streams device associated with the 
transport provider. 

Action 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

ORA-6742 

TLI Driver: cannot alloc t_bind 

Cause 

The SQL*Net server cannot allocate space for its requested network address. 

Action 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

ORA-6743 

TLI Driver: cannot alloc t_bind 

Cause 

The SQL*Net server cannot allocate space for its actual network address. 

Action 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

ORA-6744 

TLI Driver: listener cannot bind 

Cause 

% 

The SQL*Net server failed to assign the correct network address on which to 
listen for connections. 

Action 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 
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ORA-6745 

Cause 

Action 

ORA-6746 

Cause 

Action 

ORA-6747 

Cause 

Action 

ORA-6748 

Cause 

Action 

ORA-6749 

Cause 

Action 

ORA-6750 

Cause 

Action 

ORA-6751 

Cause 

Action 

ORA-6752 

Cause 

Action 


TLI Driver: listener already running 

The network address on which the SQL*Net server awaits connection requests is 
in use, possibly because the server is already running. 

Ensure that the SQL*Net server is not already running. If it is not running and 
this message recurs. Contact Oracle Worldwide Technical Support. 

TLI Driver: cannot alloc t_call 

SQL*Net cannot allocate space for the SQL*Net server's connection information. 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

TLI Driver: error in listen 

The SQL*Net server found an error while listening for connection requests. 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

TLI Driver: cannot allocate t_discon 

SQL*Net cannot allocate space for the SQL*Net server's disconnection 
information. 

Check the operating System message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

TLI Driver: option not allowed across network 

The requested SQL*Net server command must be issued from the same host on 
which the server is running. 

Log into the remote host and try again. 

TLI Driver: sync failed 

The Oracle process started by the SQL*Net server was unable to synchronize its 
inherited connection. 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

TLI Driver: bound addresses unequal 

The osn check server address failed. The bound server address was not the 
same as the requested binding address. 

Contact Oracle Worldwide Technical Support. 

TLI: error in signal setup. 

A call to sigactionO returned with a system error. 

Contact Oracle Worldwide Technical Support. 
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ORA-6753 

TLI Driver: name-to-address mapping failed. 

Cause 

For SVR4, the netdir_getbyname() call failed for some unknown reason. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-6754 

TLI Driver: unable to get local host address. 

Cause 

The name of the remote host to connect to was not specified, and the name of the 
local host cannot be retrieved from the /etc/hosts file. 

Action 

Contact your system administrator. 

ORA-6755 

TLI Driver: cannot close transport endpoint. 

Cause 

The SQL*Net server was unable to close a connection after passing it to an 

Oracle process. 

Action 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

ORA-6756 

TLI Driver: cannot open oratab. 

Cause 

The SQL*Net server could not open the file used to define the locations of 
remotely accessible databases (/var/opt/oracle/oratab). 

Action 

Ask your system administrator to check that the file exists and has the correct 
permissions. 

ORA-6757 

TLI Driver: server got bad command. 

Cause 

The SQL*Net server received an invalid command. 

Action 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

ORA-6760 

TLI Driver: timeout reading orderly release. 

Cause 

SQL*Net was not able to retrieve an expected disconnect message while closing 
the communication channel. 

Action 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

ORA-6761 

TLI Driver: error sending orderly release. 

Cause 

SQL*Net found an error sending a disconnect message closing the 
communication channel. 

Action 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 
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ORA-6762 

Cause 

Action 

ORA-6763 

Cause 

Action 

ORA-6764 

Cause 

Action 

ORA-6765 

Cause 

Action 

ORA-6766 

Cause 

Action 

ORA-6767 

Cause 

Action 

ORA-6770 

Cause 

Action 


TLI Driver: error reading orderly release. 

SQL*Net found an error receiving an expected disconnect message while closing 
the communication channel. 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

TLI Driver: error sending disconnect. 

SQL*Net found an error sending a disconnect message closing the 
communication channel. 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

TLI Driver: error reading disconnect. 

SQL*Net was not able to retrieve an expected disconnect message while closing 
the communication channel. 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

TLI Driver: error awaiting orderly release. 

SQL*Net found an error awaiting a disconnect message while closing the 
communication channel. 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

TLI Driver: close failed during release. 

SQL*Net failed to close the communication channel after receiving a disconnect 
message. 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

TLI Driver: alloc failed during release. 

SQL*Net cannot allocate space for disconnection information while closing the 
communication channel. 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

TLI Driver: error sending version. 

SQL*Net found an error while sending its version information during 
connection establishment. 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 
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ORA-6771 

TLI Driver: error reading version. 

Cause 

SQL*Net found an error while awaiting the expected version information during 
connection establishment. 

Action 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

ORA-6772 

TLI Driver: error sending command. 

Cause 

SQL*Net found an error while sending a command message during connection 
establishment. 

Action 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

ORA-6773 

TLI Driver: error reading command. 

Cause 

SQL*Net found an error while awaiting the expected command message during 
connection establishment. 

Action 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-6774 

TLI Driver: error sending break mode. 

Cause 

SQL*Net found an error while sending break-mode message during connection 
establishment. 

Action 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

ORA-6775 

TLI Driver: error reading break mode. 

Cause 

SQL*Net found an error while awaiting the expected break-mode message 
during connection establishment. 

Action 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

ORA-6776 

TLI Driver: error sending parms. 

Cause 

SQL*Net found an error while sending the connection parameters during 
connection establishment. 

Action 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 
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ORA-6777 

TLI Driver: error reading parms. 

Cause 

SQL*Net found an error while awaiting the expected connection parameter 
message during connection establishment. 

Action 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

ORA-6778 

TLI Driver: error sending ccode. 

Cause 

SQL*Net found an error while sending the completion status message during 
connection establishment. 

Action 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

ORA-6779 

TLI Driver: error reading ccode. 

Cause 

SQL*Net found an error while awaiting the expected completion status message 
during connection establishment. 

Action 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

ORA-6780 

TLI Driver: recv error code failed. 

Cause 

SQL*Net found an error while awaiting an expected error message during 
connection establishment. 

Action 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

ORA-6781 

TLI Driven error reading negotiation string. 

Cause 

SQL*Net found an error while awaiting the expected negotiation message 
during connection establishment. 

Action 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

ORA-6790 

TLI Driver: poll failed. 

Cause 

SQL*Net was unable to poll the communication channel for possible incoming 
messages. 

Action 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

ORA-6791 

TLI Driver: poll returned error event. 

Cause 

TLI received an unexpected event while polling the communication channel for 
possible incoming messages. 

Action 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 
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ORA-6792 

TLI Driver: server cannot exec oracle. 

Cause 

The remote SQL*Net server was unable to start an Oracle process on behalf of 
the client. 

Action 

Note the operating system message or number and contact your system 
administrator. The permissions on the remote Oracle program may be set 
incorrectly. 

ORA-6793 

TLI Driver: server cannot create new process. 

Cause 

The remote SQL*Net server was unable to start an Oracle process on behalf of 
the client. 

Action 

Note the operating system message or number and contact your system 
administrator. The remote host may be unable to create any new processes due 
to a full process table. 

ORA-6794 

TLI Driver: shadow process could not retrieve protocol info. 

Cause 

The Oracle process either failed to allocate memory to store the protocol 
information record, or the protocol rejected the request for some unknown 
reason. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-6800 

TLI Driver: SQL*Net SPX client went away during reconnect. 

Cause 

The client process was aborted by the system or the user, and was unable to 
complete the connection establishment with the server listener process. 

Action 

Determine cause of client exit, and attempt connection again. 

ORA-6801 

TLI Driver: listen for SPX server reconnect failed. 

Cause 

An unknown event occurred on the client's listening socket. 

Action 

Check the operating system message or number supplied with this message and 
then contact Oracle Worldwide Technical Support. 

ORA-6802 

TLI Driver: could not open the /etc/netware/yellowpages file. 

Cause 

The /etc/netware/yellowpages file does not exist, or is not readable by the TLI 
listener process. 

Action 

Ensure the file exists and is readable. Make sure that the server machine's node 
name, network number, ethernet address, and listening socket number are 
encoded in the file. 
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ORA-6803 

Cause 

Action 

ORA-6804 

Cause 

Action 

ORA-6805 

Cause 

Action 

ORA-6806 

Cause 

Action 

ORA-6807 

Cause 

Action 


ORA-6808 

Cause 

Action 

ORA-6809 

Cause 

Action 


TLI Driver: the IPX device file could not be opened. 

The /dev/ipx file does not exist, or the driver has not been installed in the kernel 
correctly. 

Re-invoke the Oracle root installation. If problem continues, contact Oracle 
Worldwide Technical Support. 

TLI Driver: could not bind an IPX address at initialization. 

The IPX driver has not been correctly installed. 

Re-invoke the Oracle root installation. If problem continues, contact Oracle 
Worldwide Technical Support. 

TLI Driver: could not send datagram SAP packet for SPX. 

The socket endpoint for sending SAP packet was corrupted for some unknown 
reason. 

Contact Oracle Worldwide Technical Support. 

TLI Driver: could not complete protocol initialization for SPX. 

A step in the SPX/IPX protocol initialization failed. 

Check the previous error reported, and follow corrective action. 

TLI Driver: could not open ethernet device driver file. 

The file /dev/eth does not exist, or the driver it references could not be opened. 

The system's real Ethernet device file, for example /dev/wd, for the Western 
Digital Ethernet driver, should be linked to the file /dev/eth. If this has been 
done, ensure that the Ethernet driver has been installed by completing the 
TCP/IP installation on your system, and testing a connection. If problem 
continues, contact Oracle Worldwide Technical Support for a list of supported 
Ethernet drivers. 

TLI Driver: could not link IPX and ethernet streams. 

Either the Ethernet driver has not been installed in the system correctly, or the 
Ethernet driver is not supported. 

Ensure that the Ethernet driver has been installed by completing the TCP/IP 
installation on your system, and testing a connection. If problem continues, 
contact Oracle Worldwide Technical Support for a list of supported Ethernet 
drivers. 

TLI Driver: could not clear the IPX ethernet SAP at init. 

The IPX driver has not been correctly installed. 

Re-invoke the Oracle root installation. I f problem continues, contact Oracle 
Worldwide Technical Support. 
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ORA-6810 

Cause 

Action 

ORA-6811 

Cause 

Action 

ORA-6812 

Cause 

Action 

ORA-6813 

Cause 

Action 

ORA-6814 

Cause 

Action 

ORA-6815 

Cause 

Action 

ORA-6816 

Cause 

Action 


TLI Driver: could not set the IPX ethernet SAP at init. 

The IPX driver has not been installed correctly. 

Re-invoke the Oracle root installation. If problem continues, contact Oracle 
Worldwide Technical Support. 

TLI Driver: could not set the IPX network number at init. 

The IPX driver has not been installed correctly, or the network number encoded 
in the /etc/netware/yellowpages file is invalid. 

The network number in the yellowpages file should match the four-byte 
network number of your Novell file server. If this is configured correctly, 
re-invoke the Oracle root installation. If problem continues, contact Oracle 
Worldwide Technical Support. 

TLI Driver: could not read the ethernet driver's node address. 

The Ethernet driver is not installed correctly, or does not support this operation. 

Contact Oracle Worldwide Technical Support for a list of supported Ethernet 
drivers. 

TLI Driver: the configured ethernet address is incorrect. 

The node address read from the Ethernet driver does not match the value 
encoded in the /etc/netware/yellowpages file for this server. 

Confirm the correct Ethernet node address for your LAN card, and enter this 
value in the yellowpages file. 

TLI Driver: the SPX device file could not be opened. 

The /dev/nspxd file does not exist, or the driver has not been installed in the 
kernel correctly. 

Re-invoke the Oracle root installation. If problem continues, contact Oracle 
Worldwide Technical Support. 

TLI Driver: could not link SPX and IPX streams. 

The SPX driver has not been installed correctly. 

Re-invoke the Oracle root installation. If problem continues, contact Oracle 
Worldwide Technical Support. 

TLI Driver: could not set the SPX SAP address. 

The SPX driver has not been correctly installed. 

Re-invoke the Oracle root installation. If problem continues, contact Oracle 
Worldwide Technical Support. 
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ORA-6817 TLI Driver: could not read the Novell network address. 

Cause The file $ORACLE_HOME/spx/address could not be opened for reading and 
writing. 

Action Make sure ORACLE_HOME is set, and the permissions on the 

ORACLE_HOME are read-write. If this file has been unintentionally deleted, 
run spxctl (net option) to reset the configured Novell network number for 
SQL*Net SPX. 
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SQL*Net X.25 Driver Messages 

ORA-6970 X.25 Driver: remote host is unknown. 

Cause Host name specified in the login (connect string) is unknown. 


Action 

Check spelling; make sure name is in the X.25 HOST file. 

ORA-6973 

X.25 Driver: invalid buffer size. 

Cause 

The buffer size specified in the login string must be between 5 and 4096. 

Action 

Re-submit with valid buffer size. 

ORA-6974 

X.25 Driver: SID lookup failure. 

Cause 

From the remote host's SQL*Net X.25 server: the database SID, specified in the 
login (connect) string, was not recognized. 

Action 

Add the appropriate SID entry to the config.ora file on the remote host (and 
restart the SQL*Net X.25 server). 

ORA-6975 

X.25 Driver: connect to host failed. 

Cause 

Connection attempt to remote host has failed. Probably means that the SQL*Net 
X.25 server on the remote host is not up, or the host itself is not up. 

Action 

Start the SQL*Net X.25 server process on the remote host. 

ORA-6976 

X.25 Driver: endpoint creation failure. 

Cause 

Process open file quota probably exceeded. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-6977 

X.25 Driver: X.25 Level 2 failure. 

Cause 

X.25 level 2 is down. X.25 link is not working. 

Action 

Run system checks to verify functioning of X.25 software. Contact your 
hardware vendor. 

ORA-6978 

X.25 Driver: Too many callback tries. 

Cause 

Call back address probably same as called address. 

Action 

Verify that callback address and called address are different. 

ORA-6979 

X.25 Driver: server cannot start oracle. 

Cause 

The remote X.25 server was unable to start an Oracle process on behalf of the 
client. 

Action 

Make sure permissions on the remote Oracle program are correctly set. Contact 
your system administrator. 
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Operating System Messages 

ORA-7200 slsid:ORACLE_SIE) not set 


Cause 

The environment variable ORACLE_SID is not set. 

Action 

Set ORACLE_SID environment variable. For more information on environment 
variables, see the "Oracle System Architecture" chapter. 

ORA-7201 

slhom:ORACLE_HOME variable not set in environment 

Cause 

ORACLE_HOME environment variable not set. 

Action 

Set ORACLE_HOME environment variable. See the "Oracle System 
Architecture" chapter for further information on environment variables. 

ORA-7202 

sltln:Invalid parameter to sltln 

Cause 

The sltln name translation routine was called with invalid arguments. The input 
or output strings were either NULL or 0 length. 

Action 

Probable internal Oracle error. Contact Oracle Worldwide Technical Support. 

ORA-7203 

sltln: Attempt to translate a long environment variable 

Cause 

A string was passed to sltln containing a long environment variable, sltln 
accepts environment names of 30 characters or less. 

Action 

Shorten the environment variable name to less than 30 characters. See the 
"Oracle System Architecture" chapter for more information. 

ORA-7204 

sltln: Name translation failed due to lack of output buffer space 

Cause 

The sltln routine is given a maximum length buffer to expand the name into. 

An overflow of this buffer has occurred. 

Action 

Check output buffer length stored in sercose[0J. Pathnames are limited to 255 
characters. 

ORA-7205 

slgtd: Time error, unable to obtain time 

Cause 

TimeO system call returned an error. Possible operating system error. 

Action 

Check the additional information returned. Contact Oracle Worldwide 

Technical Support. 

ORA-7206 

slgtd: gettimeofday error, unable to obtain time 

Cause 

GettimeofdayO system call returned an error. Possible operating system error. 

Action 

Check the additional information returned. Contact Oracle Worldwide 

Technical Support. 
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ORA-7207 

sigpidu: process ID string overflows internal buffer 

Cause 

The sigpidu routine is given a maximum length buffer to hold process ID string. 
An overflow of this buffer occurred. 

Action 

Internal error. Contact Oracle Worldwide Technical Support. 

ORA-7208 

sfwfb: failed to flush dirty buffers to disk 

Cause 

The fsync system call returned an error. Possible operating system error. 

Action 

Check the additional information returned. Contact Oracle Worldwide 

Technical Support. 

ORA-7209 

sfofi: file size limit was exceeded 

Cause 

The size of the file to be opened exceeded the operating-system limit imposed on 
this process. 

Action 

Run osh to increase the file size limit. 

ORA-7210 

slcpu:Getrusage error, unable to get cpu time 

Cause 

The getrusage system call returned an error. Possible operating-system error. 

Action 

Check the additional information returned. Contact Oracle Worldwide 

Technical Support. 

ORA-7211 

slgcs: Gettimeofday error, unable to get wall clock 

Cause 

The gettimeofday system call returned an error. Possible operating system 
error. 

Action 

Check additional information returned. Contact Oracle Worldwide Technical 
Support. 

ORA-7212 

slcpu: times error, unable to get cpu time 

Cause 

Times system call returned an error. Possible operating system error. 

Action 

Check additional information returned. Contact Oracle Worldwide Technical 
Support. 

ORA-7213 

slgcs: times error, unable to get wall clock 

Cause 

Times system call returned an error. Possible operating system error. 

Action 

Check additional information returned in your operation system reference 
manual. Contact Oracle Worldwide Technical Support. 

ORA-7214 

slgunm: uname error, unable to get system information 

Cause 

The uname system call returned an error. Possible operating system error. 

Action 

Check the additional information returned in your operating system reference 
manual. Contact Oracle Worldwide Technical Support. 
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ORA-7215 

slsget:Getrusage error 

Cause 

The getrusage system call returned an error. Possible operating-system error. 

Action 

Look up the additional information code in your Commands Reference Manual 
Contact Oracle Worldwide Technical Support. 

ORA-7216 

slghst: gethostname error, unable to get name of current host 

Cause 

gethostname system call returned an error. Possible operating system error. 

Action 

Check the additional information returned in your operating system reference 
manual. Contact Oracle Worldwide Technical Support. 

ORA-7217 

sltln: environment variable cannot be evaluated. 

Cause 

The getenv call returned a null pointer. 

Action 

Set the environment variable and try again. 

ORA-7218 

slkhst: could not perform host operation 

Cause 

UNIX systemO call failed 

Action 

Examine system error message. 

ORA-7219 

slspool: unable to allocate spooler argument buffer 

Cause 

Malloc failed to allocate space to hold spooler arguments. 

Action 

Check the additional information returned in your operating system reference 
manual. The process may have run out of heap space. Contact Oracle 
Worldwide Technical Support. 

ORA-7220 

slspool: Wait error 

Cause 

Wait returned an error when waiting for spool job to complete. Possible spooler 
program error. 

Action 

Look up the additional information code in your Commands Reference Manual. 
Contact Oracle Worldwide Technical Support. 

ORA-7221 

slspool: Exec error, unable to start spooler program 

Cause 

Exec failed when starting line printer spooler command. It is likely that either 
the default line printer command or ORACLE_LPPROG is incorrectly set. 

Action 

Verify that the default line printer command and ORACLEJLPPROG are set 
correctly. Set ORACLE_LPPROG to the name of your printer program. You 
should be able to find this information in your operating system manual. 
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ORA-7222 

slspool: Line printer spooler command exited with an error 

Cause 

The line printer spooler exited with a non-zero return value. This probably 
indicates an error in the spooling file. 

Action 

Verify that the line printer spooler is up. Verify that ORACLE_LPPROG and 
ORACLE_LPARG are set properly. Check exit value returned as additional 
information. 

ORA-7223 

slspool: Fork error, unable to spawn spool process 

Cause 

Fork system call failed to create an additional process. Possible system limit 
reached. 

Action 

Look up the additional information code in your Commands Reference Manual, 
and retry the operation. Contact Oracle Worldwide Technical Support. 

ORA-7224 

sfnfytfailed to obtain file size limit: errno =%s 

Cause 

The ulimit system call returned an error. 

Action 

Check number and contact Oracle Worldwide Technical Support. 

ORA-7225 

sldext:Translation error, unable to expand file name 

Cause 

Additional information returned is error returned from sltln. 

Action 

Look up the additional information code in your Commands Reference Manual. 

ORA-7226 

slsprom: unable to get terminal mode 

Cause 

The ioctl call returned an error. Possible operating system error. 

Action 

Check the additional information for an error number. Contact Oracle 
Worldwide Technical Support. 

ORA-7227 

slsprom: unable to set noecho mode 

Cause 

The ioctl call returned an error. Possible operating system error. 

Action 

Check the additional information for an error number. Contact Oracle 
Worldwide Technical Support. 

ORA-7228 

slsprom: unable to restore terminal to echo mode 

Cause 

The ioctl call returned an error. Possible operating system error. 

Action 

Check the additional information returned for an error number. Contact Oracle 
Worldwide Technical Support. 


ORA-7230 slemcr: fopen error, unable to open error file 
Cause The fopen system call failed to open the file. 

Action Try to determine which file was not opened. Check that file to see if it exists and 
is accessible. 
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ORA-7231 

slemcc: Invalid file handle, seals do not match 

Cause 

The function was called with an invalid file handle. The file handle was not 
obtained by slemcr. 

Action 

Internal error. Contact Oracle Worldwide Technical Support. 

ORA-7232 

slemcc: Fclose error 

Cause 

An error was found when closing the file. Possible operating-system error. 

Action 

Contact your system administrator. 

ORA-7233 

slemcw: Invalid file handle, seals do not match 

Cause 

The function was called with an invalid file handle. The file handle was not 
obtained by slemcr. 

Action 

Internal error. Contact Oracle Worldwide Technical Support. 

ORA-7234 

slemcw: Fseek error 

Cause 

Unable to seek to desired position in file. Possible operating-system error or 
internal error. 

Action 

Verify that the message file exists and is intact. Try to regenerate the message 
file. Contact Oracle Worldwide Technical Support. 

ORA-7235 

slemcw: Fwrite error 

Cause 

Unable to write item to file. Possible operating-system error. 

Action 

Retry the operation. Check whether the file and the directory can be written to. 
Contact your system administrator. 

ORA-7236 

slemop: Fopen error 

Cause 

Unable to open error file. Possible permissions problem. 

Action 

Verify permissions on the error message file. 

ORA-7237 

slemcl: Invalid file handle, seals do not match 

Cause 

The function was called with an invalid file handle. The handle was not 
obtained by a previous call to slemop. 

Action 

Internal error. Contact Oracle Worldwide Technical Support. 

ORA-7238 

slemcl: Fclose error 

Cause 

Unable to close file. Possible operating system error. 

Action 

Contact your system administrator. 
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ORA-7239 

slemrd: Invalid file handle, seals do not match 

Cause 

A function was called with an invalid file handle. The handle was not obtained 
by a call to slemop. 

Action 

Internal error. Contact Oracle Worldwide Technical Support. 

ORA-7240 

slemrd: Fseek error 

Cause 

Unable to seek to desired position in file. Possible operating system error. 

Action 

Check that the error file is still intact. Verify space on the device. Contact your 
systems administrator. 

ORA-7241 

slemrd: Fread error 

Cause 

Unable to read file. Possible operating system error. 

Action 

Verify that the error file is intact. Regenerate the message file. Run lmsgen. 
Contact Oracle Worldwide Technical Support. 

ORA-7242 

slembfn: Translation error, unable to translate error file name 

Cause 

Additional information is error number returned from sltln. 

Action 

Look up the additional information code in your Commands Reference Manual. 

ORA-7243 

sftget: supplied buffer not big enough to hold entire line 

Cause 

The fgets call read only part of the line because the supplied buffer was not big 
enough. 

Action 

Internal error. Additional information indicates how big the supplied buffer 
was. Contact Oracle Worldwide Technical Support. 

ORA-7244 

ssfccf: create file failed, file size limit reached. 

Cause 

An attempt was made to create a file that exceeds the process file size limit. 

Action 

Run osh to raise the file size limit. 

ORA-7245 

sfccf: unable to lseek and write the last block. 

Cause 

An attempt was made to move and write to a bad device address. 

Action 

Check errno. Possible lack of space on device. 

ORA-7246 

sfofi: open error, unable to open database file. 

Cause 

sfofi returns an error. 

Action 

This is an Oracle internal error. 

ORA-7247 

sfrfb: read error, unable to read requested block from database file. 

Cause 

sfrfb returns an error. 

Action 

This is an Oracle internal error. 
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ORA-7248 

Cause 

Action 

ORA-7249 

Cause 

Action 

ORA-7250 

Cause 

Action 

ORA-7251 

Cause 

Action 

ORA-7252 

Cause 

Action 

ORA-7253 

Cause 

Action 

ORA-7254 

Cause 

Action 


sfwfb: write error, unable to write database block, 
sfwfb returns an error. 

This is an Oracle internal error. 

slerop: fcntl error, unable to set close-on-exec flag. 

An error occurred when trying to set the close-on-exec flag after successfully 
opening a message file. 

Check additional information for errno. 

spcre: Semget error, unable to get first semaphore set 

An error occurred when trying to get first semaphore set. 

Verify that the system is configured to have semaphores, and that enough 
semaphores are available. See the "Oracle System Architecture" chapter for 
further information on semaphores. For additional information code, see your 
Commands Reference Manual. 

spcre: Semget error, could not allocate any semaphores 

Semget failed to allocate even a single semaphore. They all may be in use or the 
system may not be configured to have any semaphores. 

Check to see if all semaphores are in use or if the system is configured to have 
semaphores. See the "Oracle System Architecture" chapter for further 
information on semaphores. For additional information code, see your 
Commands Reference Manual. 

spcre: Semget error, could not allocate semaphores 

The semget system call returned an error. Possible resource limit problem. 

Look up the additional information code in your Commands Reference Manual. 
Verify that enough semaphores are available in the system. If additional errors 
occur, destroying the semaphore sets, then sercose[0] will be non-zero. If this 
occurs, remove the semaphore sets using ipcrm. 

spdes: Semctl error, unable to destroy semaphore set 

The semctl system call returned an error. 

Check the semaphore sets. Manual cleanup may be required. For additional 
information code, see your Commands Reference Manual. 

spdcr: Translation error while expanding ?/bin/oracle 

An error occurred while translating the name of the oracle executable. 

Check sercose[0] for error returned from sltln. Perhaps $ORACLE_HOME is 
not set correctly. See the "Oracle System Architecture" chapter for more 
information. 
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ORA-7255 

spini: Chdir error, unable to change directory to ?/dbs 

Cause 

The chdir system call returned an error when attempting to change directories to 

$ORACLE_HOME/dbs. 

Action 

See the additional information code in your Commands Reference Manual. Verify 
the existence of the ?/dbs directory, and the permissions on it. 

ORA-7256 

spini: Translation error when translating ?/dbs 

Cause 

Unable to translate ?/dbs 

Action 

See additional information code in your Commands Reference Manual. 

ORA-7257 

spdcr: Translation error expanding program name 

Cause 

An error occurred when expanding the program name ora_PNAME_@. The 
result of this translation is put in argv[0] of the oracle process. 

Action 

Check the Oracle error returned by sltln in sercose[0]. 

ORA-7258 

spdcr: Fork error, unable to create process 

Cause 

An error occurred when creating a new process. 

Action 

Look up the additional information code in your Commands Reference Manual. 
Perhaps a system limit on the number of processes has been exceeded. Wait for 
other processes to exit and try again. Reconfigure the UNIX kernel to allow for 
more processes. 

ORA-7259 

spdcr: Exec error, detached process failed in startup 

Cause 

An oracle detached process died shortly after startup. WaitO indicated that a 
child process terminated. 

Action 

Check the ?/dbs directory for trace or core files. Look up the additional 
information code in your Commands Reference Manual. Contact Oracle 

Worldwide Technical Support. 

ORA-7260 

spdcr: Wait error 

Cause 

The wait system call returned an error. 

Action 

Look up the additional information code in your Commands Reference Manual. 

ORA-7261 

spdde: Kill error, unable to send signal to process 

Cause 

The kill system call returned an error. Possibly an attempt to destroy a process 
already gone. 

Action 

Check the setuid permission bit on Oracle. It should be set to the Oracle 
executable. See additional information code in your Commands Reference Manual. 
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ORA-7262 

sptpa: fptpa called with invalid process id 

Cause 

Internal error. 

Action 

This is an Oracle internal error. Contact Oracle Worldwide Technical Support. 

ORA-7263 

sptpa: Kill error 

Cause 

Kill system call returned an error. Possible operating-system error. 

Action 

Check the setuid permission bit on Oracle. It should be set to the Oracle 
executable. See additional information code in your Commands Reference Manual. 
Check ?/dbs for trace files or core files. Contact Oracle Worldwide Technical 
Support. 

ORA-7264 

spwat: Semop error, unable to decrement semaphore 

Cause 

The semop system call returned an error. Semaphore set may not exist. 

Action 

See additional information code in your Commands Reference Manual. Semaphore 
ID is returned in sercose[0]. Verify that the semaphore set exists. Shut down 
database and restart. 

ORA-7265 

sppst: Semop error, unable to increment semaphore 

Cause 

The semop system call returned an error. Semaphore set may not exist. 

Action 

See additional information code in your Commands Reference Manual. Semaphore 
ID is returned in sercose[0]. Verify that the semaphore set exists. Shut down 
database and restart. 

ORA-7266 

sppst: Invalid process number passed to sppst 

Cause 

The function sppst was passed an invalid oracle process ID. 

Action 

Internal error. Contact Oracle Worldwide Technical Support. 

ORA-7267 

spwat: Invalid process number 

Cause 

The function spwat was passed an invalid oracle process ID. 

Action 

Internal error. Contact Oracle Worldwide Technical Support. 

ORA-7268 

spgun: Getpwuid error 

Cause 

The getpwuid library routine returned an error. 

Action 

Possible operating-+system error. Consult your systems administrator. 

ORA-7269 

spdcr: Detached process died after exec 

Cause 

Detached process executed successfully, but died shortly thereafter. Additional 
information indicates exit code, and termination status. 

Action 

Check termination code for information as to why the process exited. Check for 
core dump or trace file in the ?/dbs directory. Contact Oracle Worldwide 
Technical Support. 
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ORA-7270 

spalck: Setitimer error, unable to set interval timer 

Cause 

An error occurred while trying to set an interval timer. Internal error. 

Action 

Check the number. See additional information code in your Commands Reference 
Manual. 

ORA-7271 

spwat: Invalid oracle process number 

Cause 

Function was called with an invalid oracle process number (0). 

Action 

Internal Oracle error. Contact Oracle Worldwide Technical Support. 

ORA-7272 

spwat: Invalid semaphore set id 

Cause 

The semaphore ID fetched from the SGA was not initialized to a valid value. 
Additional information returned is the semaphore set index, and the oracle 
process number. 

Action 

Oracle internal error. Check the semaphore set index and the oracle process 
number. The semaphore ID must be initialized to a positive value. 

ORA-7273 

sppst: Invalid semaphore ID 

Cause 

The semaphore ID fetched from SGA contained an invalid value. Additional 
information returned is semaphore set index, and oracle process number. 

Action 

Oracle internal error. Check the semaphore set index and the oracle process 
number. Contact Oracle Worldwide Technical Support. 

ORA-7274 

spdcr: Access error, access to oracle denied 

Cause 

Unable to access oracle program. Verify that ?/bin/oracle exists. 

Action 

Look up the additional information code in your Commands Reference Manual. 

ORA-7275 

spdba: Getpwuid error, no passwd entry 

Cause 

The getpwuid system call returned no passwd entry for this user. Possible 
operating-system error. 

Action 

Contact your system administrator. Check validity of password files. Contact 
Oracle Worldwide Technical Support. 

ORA-7276 

spdba: No dba group in /etc/group 

Cause 

A group has not been set up for dba users. 

Action 

Contact your system administrator. Set up dba group in /etc/group. 

ORA-7277 

spdde: Illegal pid passed as argument 

Cause 

A pid of 0 was passed to spdde. 

Action 

Internal error. Contact Oracle Worldwide Technical Support. 
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ORA-7278 

Cause 

Action 

ORA-7279 

Cause 

Action 

ORA-7280 

Cause 

Action 

ORA-7281 

Cause 

Action 

ORA-7282 

Cause 

Action 

ORA-7283 

Cause 

Action 

ORA-7284 

Cause 

Action 


splon: Ops$username exceeds buffer length 

splon constructed an ops$username logon that exceeded the allotted buffer 
space. 

Use a shorter UNIX username, or use an Oracle username. Contact Oracle 
Worldwide Technical Support. 

spcre: semget error, unable to get first semaphore set 

An error occurred when trying to get first semaphore set. 

Check the additional information returned. Verify that the system is configured 
to have semaphores. Verify that enough semaphores are available. 

soarch: malloc of temporary buffer for file-to-file copy failed 

MallocO failed to allocate buffer for log archiving. 

You have run out of heap space on your machine. 

sorach: interrupt received 

An interrupt was received while archiving the logs. 

Retry operation. 

soaprd: string overflow 

The internal buffer is not big enough to hold the archive control string. 

This is an internal restriction. Try a shorter archive control string. The archive 
control string is the argument for the init.ora parameter log_archive_dest. This 
is the same argument used with the archive log start statement. It specifies the 
device for archiving, and (in the case of tape) the size of the archive file. 

soaprd: invalid volume size in archive control string 

You specified an invalid volume size in the archive control string (see Error 
ORA-7282). 

Change the volume argument in the string to a valid size. 

soaprd: volume size specification not terminated properly 

Some non-numeric text follows the volume specification in the archive control 
string (See Error ORA-7282). The only non-numeric text you can enter after 
volume in the archive control string is "B" (for "bytes"), "M" (for "megabytes"), 
or "K" (for "kilobytes"). You entered something else. 

Enter the archive control string correctly. 
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ORA-7285 

Cause 

Action 

ORA-7286 

Cause 

Action 

ORA-7287 

Cause 

Action 

ORA-7288 

Cause 

Action 

ORA-7289 

Cause 

Action 

ORA-7290 

Cause 

Action 

ORA-7292 

Cause 

Action 


soaprd: volume size should not be specified for a disk file 

You specified a volume argument for a disk file. You can only specify a volume 
size if your archive destination is tape. 

If you are archiving to a disk file, do not specify its size. If you are archiving to a 
tape file, specify the device correctly. 

soagdi: cannot obtain device information 

The stat system call on the log archiving device failed. 

Check the returned OSD error for the reason of failure. 

soagdi: unsupported device for log archiving 

Log archiving to the device you specified in the archiving control string is not 
supported. You may also have mistyped the string. 

Either correct your typing, or use a device that is supported. 

soabfn: string overflow when constructing filename 

The internal buffer is not big enough to hold the fully qualified name for the 
archive destination. 

This is an internal restriction on the size of the filename string length, similar to 
the control string restriction cited in ORA-7282. Enter a shorter device 
specification for the archive destination. 

soafls: write to tape failed. 

The write system call failed on the tape device. 

Check additional information for the operating system error. Verify that the tape 
is mounted correctly. r 

soagdi: specified directory for archiving does not exist. 

The specified pathname is not a directory. 

Verify that the archive destination directory exists. 

soaotp: tape volume is too small to accommodate the log file 

The current tape volume cannot accommodate the entire log file. The file size 
specified for the archived log file is larger than the volume specified for the 
destination tape. 

Either increase the volume specification in the archive control string, or decrease 
th efilesize specification in the log file string. Additional information indicates 
the size of the log file and tape volume size. 
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ORA-7293 

soaotp: cannot open the current tape volume 

Cause 

The open system call failed on the tape device. 

Action 

Check this as you would any UNIX system error. 

ORA-7294 

soatp: cannot allocate buffer for tape write 

Cause 

MallocO failed to allocate buffer space for writing to tape. 

Action 

You have run out of heap space on your machine. 

ORA-7295 

soatp: cannot find out the status of log file 

Cause 

The stat system call failed to return the status of the log file. 

Action 

Verify that the log file still exists. If it does, check this as you would any UNIX 
error. 

ORA-7296 

soaotp: lseek error, unable to seek to beginning of log file 

Cause 

An lseek was executed, but failed to seek to the beginning of the log file. 

Action 

Check this as you would any UNIX error. 

ORA-7297 

soaotp: read error, unable to read header block 

Cause 

The read system call was unable to read the log file, and returned an error. 

Action 

Check this as you would any UNIX error. 

ORA-7298 

soacls: trying to close a file that has been closed 

Cause 

The system is trying to close a file with an invalid file descriptor. 

Action 

This is an internal error. Contact Oracle Worldwide Technical Support. 

ORA-7299 

soacls: failed to close the tape device 

Cause 

The close system call failed on the tape device. 

Action 

Verify that the tape is still on-line. Otherwise, check this as you would any 
UNIX error. 

ORA-7300 

smscre: Translation error while expanding ?/dbs/sgadef.dbf 

Cause 

There was a failure of sltln(?/sgadef@.dbf) in smscre. 

Action 

Look up the additional information code in your Commands Reference Manual 
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ORA-7301 

Cause 


Action 


ORA-7302 

Cause 

Action 

ORA-7303 

Cause 

Action 

ORA-7304 

Cause 

Action 

ORA-7305 

Cause 

Action 

ORA-7306 

Cause 

Action 


smscre: Sgadef.dbf file already exists when creating SGA 

The sgadef.dbf file should not exist when trying to create the SGA; otherwise, a 
running Oracle instance could be destroyed. The error from sltln is stored in 
sercose[0]. 

Verify that the database is really down, and delete the sgadef.dbf file. This error 
should only happen when the system has crashed with the database up. Clean 
out sgadef files in the $ORACLE_HOME/dbs/etc/rc directory. 

smscre: Create failure in creating sgadef.dbf file 

CreateO failed when trying to create the sgadef.dbf file. 

Verify permissions on the $ORACLE_HOME/dbs directory. 

smscre: Illegal DB block size 

The database block size must be a multiple of the machine block size, and less 
than the maximum block size. 

Verify that the db_block_size parameter is correct in the init.ora file. See the 
"Oracle System Architecture" chapter for additional information. 

smscre: Illegal redo buffer size 

The redo buffer size must be a multiple of the machine block size. 

Verify that the log_buffer parameter of the init.ora file is correctly set (usually 
512 Kb). See your operating system documentation for further information. 

smslsg: Ftok error in creating SGA 

The ftokO library call failed in smscreO. 

Verify that the sgadef.dbf file exists. If it exists, then the error may be the result 
of a possible system failure. 

smslsg: Shmget error, unable to get a shared memory segment 

Error in shmget. This section of code tries to find a single segment large enough 
for the entire SGA. 

See the additional information code in your Commands Reference Manual. Verify 
that enough shared memory is available on the system to fit the entire SGA. It 
may be necessary to reconfigure the kernel. See the "Oracle System 
Architecture" chapter for further information. 
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ORA-7307 

smslsg: Shmat error, unable to attach SGA 

Cause 

Failed to attach shared memory segment, after getting it. 

Action 

See additional information code in your Commands Reference Manual. Verify that 
the SGA attach address is valid. Look for sgabeg in ksms.s in rdbms.lib. If you 
don't find it, run genksms. See the "Oracle System Architecture" chapter for 
more information. 

ORA-7308 

smscre: Write error when writing sgadef.dbf file 

Cause 

A write call failed in smscre. 

Action 

See additional information code in your Commands Reference Manual. Possibly 
out of space on device. Delete unnecessary files to create additional space. 

ORA-7309 

smscre: Close error, unable to close the sgadef.dbf file 

Cause 

Close system call returned an error. 

Action 

See additional information code in your Commands Reference Manual. Possible 
operating system failure. 

ORA-7310 

smscre: Unable to create SGA 

Cause 

No SGA models defined for system. This error should only occur when you are 
porting. 

Action 

Oracle system failure. Contact Oracle Worldwide Technical Support. 

ORA-7311 

smsdes: Name translation failure of the sgadef.dbf file name 

Cause 

The system is unable to expand out the ?/sgadef.dbf file name. 

Action 

Verify that ORACLE_HOME and ORACLE_SID are properly set. Check the 
error number returned from sltln in your Commands Reference Manual. 

ORA-7312 

smsdes: Open error, unable to open sgadef.dbf file 

Cause 

Open failed when trying to open sgadef.dbf file. 

Action 

See additional information code in your Commands Reference Manual. Verify that 
the sgadef.dbf file exists. There may be a problem with permissions on the file. 

ORA-7313 

smsdes: Read error, unable to read sgadef.dbf file 

Cause 

Read system call returned an error when attempting to read ?/dbs/sgadef.dbf. 

Action 

See additional information code in your Commands Reference Manual. The sgadef 
file may be corrupted or incompatible with Oracle version. Shut down and 
restart the database. Contact Oracle Worldwide Technical Support if the error 
recurs. 
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ORA-7314 

Cause 

Action 


ORA-7315 

Cause 

Action 

ORA-7316 

Cause 

Action 

ORA-7317 

Cause 

Action 


ORA-7318 

Cause 

Action 

ORA-7319 

Cause 

Action 


ORA-7320 

Cause 

Action 


smsdes: Shmctl error when trying to destroy shared memory segment 

The shmctl(IPC_RMID) call failed when trying to destroy shared memory 
segment. 

See additional information code in your Commands Reference Manual. Verify that 
shared memory segments exist. There may be a permission problem; it may be 
necessary to manually remove segments. 

smsdes: Close error, unable to close sgadef.dbf file 
An error occurred in closeO, when closing the sgadef.dbf file. 

Verify that the sgadef.dbf file has been deleted. There may be an operating 
system error. 

smsdes: Unlink error, unable to destroy sgadef.dbf file 

An unlinkO error occurred when attempting to destroy the sgadef.dbf file. 

See additional information code in your Commands Reference Manual. Verify that 
the sgadef.dbf file has been destroyed. Manual cleanup may be required. 

smsget: Translation error when expanding sgadef.dbf filename 

An error occurred translating ?/dbs/sgadef.dbf. 

Verify that ORACLE_HOME and ORACLE_SlD are set correctly. See the 
"Oracle System Architecture" chapter for further information. Check the error 
returned from sltln as additional error. 

smsget: Open error when opening sgadef.dbf file 

The system is unable to open the sgadef.dbf file. 

See additional information code in your Commands Reference Manual. Possible 
permission problem. Verify that the sdagef.dbf file exists. Shut down and 
restart the database. 

smsget: Read error when trying to read sgadef.dbf file 

Read encountered an error when reading the sgadef.dbf file. 

See additional information code in your Commands Reference Manual. Verify that 
the file exists, and that it is the correct size. Shut down and restart the database. 
Contact Oracle Worldwide Technical Support. 

smsget: Shmat error when trying to attach SGA 

The system was unable to attach segment. 

sercose[0] returns segment id. See additional information code in your 
Commands Reference Manual. Verify that the segment exists and that permissions 
are correct. There may be a corrupted SGA file. A shared memory segment may 
have been removed. Shut down and restart the database. 
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ORA-7321 

Cause 

Action 

ORA-7322 

Cause 

Action 

ORA-7323 

Cause 

Action 

ORA-7324 

Cause 

Action 

ORA-7325 

Cause 

Action 

ORA-7326 

Cause 

Action 

ORA-7327 

Cause 

Action 

ORA-7328 

Cause 

Action 


smsget: Shmat error, unable to attach segment at requested address 

sercose[0] returns segment id. 

See additional information code in your Commands Reference Manual. Possible 
operating system error. 

smsget: Close error, unable to close sgadef.dbf file 

The system was unable to close the sgadef.dbf file. 

Retry the operation. There may be an operating system error, 
smsfre: Shmdt error, unable to delete SGA 
There is a problem deleting shared segments. 

Retry the operation. See additional information code in your Commands 
Reference Manual. Manual cleanup of shared memory segments may be required. 

smpall: Malloc error while allocating PGA 

The malloc library routine returned an error. 

See additional information code in your Commands Reference Manual. There may 
not be enough heap space. Relocate the SGA. See the "Oracle System 
Architecture" chapter for information on relocating the SGA. Contact Oracle 
Worldwide Technical Support. 

smsacx: Malloc error when allocating context area 

The malloc library routine returned an error. 

See additional information code in your Commands Reference Manual. There may 
not be enough heap space. Relocate the SGA. See the "Oracle System 
Architecture" chapter for information on relocating the SGA. Contact Oracle 
Worldwide Technical Support. 

smsfre: Attempt to free un-mapped SGA 

Smsfre was called when the SGA was not mapped. 

Oracle internal error. Contact Oracle Worldwide Technical Support. 

smpdal: Attempt to destroy PGA when it was not mapped 

Smpdal was called when the PGA had not been previously created. 

Internal error. Contact Oracle Worldwide Technical Support. 

smsmax: Cannot guess the maximum size for a segment 

Shmget system call returned a fatal error. 

Check additional information returned. Additional information indicates the 
SGA model attempted. 
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ORA-7329 

Cause 

Action 

ORA-7330 

Cause 

Action 

ORA-7331 

Cause 

Action 

ORA-7332 

Cause 

Action 

ORA-7333 


smscsg: Too many shared memory segments 

The internal data structure that holds segment information is full. 

Reconfigure the UNIX kernel to have larger segments. See the "Oracle System 
Architecture" chapter for additional information. 

smsnsg: Unable to allocate the fixed portion of the SGA 

The fixed portion of the SGA is too big to fit contiguously into one segment. 

Reconfigure the UNIX kernel to have larger segments. See the "Oracle System 
Architecture" chapter for additional information. 

smsnsg: Unable to allocate the variable portion of the SGA 

The variable portion of the SGA is too big to fit continuously into one segment. 

Reconfigure the UNIX kernel to have bigger segments. See the "Oracle System 
Architecture" chapter for additional information. 

smsnsg: Unable to allocate redo buffers 

Redo block size is too big, preventing each buffer from being allocated 
contiguously. 

Reconfigure the UNIX kernel to have bigger segments, or reduce the value of 
log_buffer parameter in init.ora. See the "Oracle System Architecture" chapter 
for additional information. 

smsnsg: Unable to allocate database buffers 


Cause 


Action 


ORA-7334 

Cause 

Action 

ORA-7335 

Cause 

Action 


Database block size is too big, preventing each buffer from being allocated 
contiguously. 

Reconfigure the UNIX kernel to have larger segments, or reduce the value of 
db_block_size parameter in init.ora. See the "Oracle System Architecture" 
chapter for additional information. 

smsnsg: Too many shared memory segments 

The internal data structure that holds segment information is full. 

Reconfigure the UNIX kernel to have larger segments. See the "Oracle System 
Architecture" chapter for additional information. 

smsmat: ftok error in creating SGA 

The ftokO library call failed in smsmatO. 

Verify that sgadef.dbf file exists. If it does, then this is a possible system failure. 
If it doesn't, shut down and restart the database. Additional information 
indicates the SGA model attempted. Contact Oracle Worldwide Technical 
Support. 
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ORA-7336 

Cause 

Action 


ORA-7337 

Cause 

Action 

ORA-7338 

Cause 

Action 

ORA-7339 

Cause 

Action 

ORA-7340 

Cause 

Action 

ORA-7341 

Cause 

Action 


ORA-7342 


smsmat: shmget error, unable to get a shared memory segment 
Error in shmget. 

Check additional information returned. Verify that enough shared memory is 
available on the system to fit the entire SGA. Additional information indicates 
the SGA model attempted. Reconfigure the UNIX kernel or modify the init.ora 
parameters. See the "Oracle System Architecture" chapter for further 
information. 

smsmat: shmat error, unable to attach SGA 

Failed to attached shared memory segment, after getting it. 

Check additional information returned. Verify that SGA attach address is valid. 
Additional information indicates the SGA model attempted. 

smscre rcannot test for existence of the sga file 

The access system call returned an error. Possible operating-system error. 

Check the error number returned and the permission on the sga file. 

spcre: maximum number of semaphore sets exceeded 

The internal buffer is not big enough to hold the number of semaphore set 
identifiers requested. 

Reconfigure operating system to have more semaphores per set. 

Fstat error, unable to obtain file status 

Unable to obtain file status. Further error closing file is returned as additional 
information. 

Verify that database files exist, and have proper permissions. 

sfsrd: Invalid block number 

The block number requested was out of bounds for the file. Additional 
information returned indicates block number. 

Verify block number. Run dbfsize on that file to determine the number of blocks 
in that file. The block number must be less than the number of blocks. See the 
"Oracle System Architecture" chapter for additional information. Contact 
Oracle Worldwide Technical Support. 

sfsrd: Lseek error, unable to seek to requested block 


Cause Additional information returns block number. 

Action Check additional information returned. Check block number. Contact Oracle 
Worldwide Technical Support. 
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ORA-7343 

Cause 

Action 

ORA-7344 

Cause 

Action 

ORA-7346 

Cause 

Action 

ORA-7347 

Cause 

Action 

ORA-7348 

Cause 

Action 

ORA-7350 

Cause 

Action 

ORA-7351 


sfsrd: Read error, unable to read requested block 

Read system call returned an error. 

Check additional information returned. Additional information indicates block 
number. Contact Oracle Worldwide Technical Support. 

sfsrd: Seals don't match 

Function was called with invalid argument. 

Internal error. Contact Oracle Worldwide Technical Support, 
sfofi: open error, unable to open database file, 
sfofi returns an error. 

This is an Oracle internal error. 

sfrfb: read error, unable to read block from database file, 
sfrfb returns an error. 

This is an Oracle internal error. 

sfwfb: write error, unable to write database block. 

sfwfb returns an error. 

This is an Oracle internal error, 
sfccf: Logical block size is invalid 

The logical block size for Oracle files must be a multiple of the physical block 
size, and less than the maximum. 

The block size specified is returned as additional information. Check the 
init.ora parameters. 

sfccf: Malloc error, unable to allocate write buffer 


Cause 

Action 


ORA-7352 

Cause 

Action 


The malloc library routine returned an error. 

Verify that adequate system resources are available. If this occurs when 
initializing the database, try again. If error recurs, contact Oracle Worldwide 
Technical Support. If this occurs when adding a files to the database, relocate 
the SGA to a higher address. If error recurs, contact Oracle Worldwide Technical 
Support. See the "Oracle System Architecture" chapter for more information on 
relocating the SGA. 

sfccf: Create error, unable to create file 

Create system call returned an error because it was unable to create the database 
file. 

Verify the filename and permissions. 
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ORA-7353 

sfccf: Close error, unable to close file 

Cause 

Close system call returned an error. 

Action 

See additional information code for the error returned from sercose[0]. 

ORA-7354 

sfccf: Open error, unable to open file 

Cause 

Open system call returned an error because it was unable to open the database 
file. 

Action 

See additional information code in your Commands Reference Manual for the error 
returned from sercose[0]. 

ORA-7355 

sfccf: Fstat error, unable to obtain file status 

Cause 

Unable to obtain file status. Another error closing file is returned as additional 
information. 

Action 

Verify that the database files exist, and make sure you have the proper 
permissions. 

ORA-7356 

sfccf: Lseek error, unable to seek to beginning of file 

Cause 

Additional information indicates if close also failed. 

Action 

See additional information code in your Commands Reference Manual. 

ORA-7357 

sfccf: Write error, unable to write database header block 

Cause 

Write system call returned an error because it was unable to write the database 
file. 

Action 

See additional information code in your Commands Reference Manual. An 
operating system error will be returned. See your operating system 
documentation. Additional information will be returned if the close of the file 
fails. 

ORA-7358 

sfccf: Write error, unable to write to the file 

Cause 

The additional information line indicates if the close system call failed. 

Action 

See additional information code in your Commands Reference Manual. Possibly, 
there is not enough space on the device. 

ORA-7359 

sfifi: Invalid logical block size 

Cause 

An incorrect block size was specified. The logical block size must be a multiple 
of the physical block size, and smaller than the maximum block size. 

Action 

Additional information returns the block size specified. Check block size 
parameters in the init. ora file. 


7-78 Oracle7 for UNIX 








ORA-7360 

Cause 

Action 

ORA-7361 

Cause 

Action 

ORA-7362 

Cause 

Action 


ORA-7363 

Cause 

Action 


ORA-7364 

Cause 

Action 

ORA-7365 

Cause 

Action 

ORA-7366 

Cause 

Action 


sfifi: Stat error, unable to obtain information about file 

Stat system call returned an error. 

See additional information code in your Commands Reference Manual. Make sure 
the file exists. Check permission on the file. Contact Oracle Worldwide 
Technical Support. 

sfifi: Malloc error, unable to allocate buffer for header block 

Malloc library routine returned an error. Possibly, there is not enough memory 
resource. 

Internal Oracle error. Contact Oracle Worldwide Technical Support, 
sfifi: Open error, unable to open file 
Open system call returned an error. 

See additional information code in your Commands Reference Manual. Verify that 
the files exist, and that you have the correct permissions. Contact Oracle 
Worldwide Technical Support. 

sfifi: Lseek error, unable to seek to beginning of file 

Lseek system call returned an error. 

See additional information code in your Commands Reference Manual. The 
additional information line indicates if there was an error in closing the file. See 
your operating system documentation for the error number returned from close. 


sfifi: Read error, unable to read header block 

The read system call returned an error because it was unable to read a database 
file. 

Check the number. See additional information code in your Commands Reference 
Manual. Check your operating system documentation for additional 
information. 

sfifi: Close error 

The close system call returned an error. 

See additional information code in your Commands Reference Manual. Check 
your operating system documentation for the error number returned. 

sfifi: Invalid file, file does not have valid header block 

This file does not appear to be a valid database file. 

Verify that the database files are correct. 
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ORA-7367 

sfifi: Logical block size mismatch 

Cause 

The logical block size of the file is not the expected block size. 

Action 

Verify that the logical block size is correct. Run dbfsize to determine your block 
size. Contact Oracle Worldwide Technical Support. 

ORA-7368 

sfofi: Open error, unable to open database file 

Cause 

The open system call returned an error. 

Action 

See additional information code in your Commands Reference Manual. Verify that 
the files exist, and that you have the correct permissions. 

ORA-7369 

sfcfi: Close error, unable to close database file 

Cause 

The close system call returned an error. 

Action 

See additional information code in your Commands Reference Manual. 

ORA-7370 

sfrfb: Invalid block number 

Cause 

The block number requested was out of bounds for the file. The additional 
information line indicates the block number. 

Action 

Verify that the block number is correct. 

ORA-7371 

sfrfb:Lseek error, unable to seek to requested block 

Cause 

The additional information line returns the block number. 

Action 

See additional information code in your Commands Reference Manual. Verify that 
the block number is correct. 

ORA-7372 

sfrfb: Read error, unable to read requested block from database file 

Cause 

The read system call returned an error. 

Action 

The additional information line indicates the block number. See additional 
information code in your Commands Reference Manual. 

ORA-7373 

sfrfb: Read returned incorrect number of bytes 

Cause 

Possible truncated read of database file. The additional information line returns 
the block number and the actual number of bytes read. 

Action 

Verify that the block number and number of bytes read are correct. Contact 
Oracle Worldwide Technical Support. 

ORA-7374 

sfwfb: Invalid block number 

Cause 

The file block number is out of range of the file. The additional information line 
returns the block number. 

Action 

Verify that the block number is correct. Run dbfsize and check if the block 
number is in that range. Contact Oracle Worldwide Technical Support. 
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ORA-7375 

sfwfb: Lseek error, unable to seek to requested block 

Cause 

The lseek system call returned an error. 

Action 

The additional information line indicates the block number. Verify that the block 
number is correct. 

ORA-7376 

sfwfb: Write error, unable to write database block 

Cause 

The write system call returned an error. 

Action 

See additional information code in your Commands Reference Manual. The 
additional information line returns the block number. Check block number. 

ORA-7377 

sfwfb: Write returned incorrect number of bytes 

Cause 

This write may have been truncated. The additional information line returns the 
block number and number of bytes. 

Action 

The additional information line returns the block number and number of bytes. 
Verify that the block number and the number of bytes written are correct. 

ORA-7378 

sfcmf: Translation error, unable to expand file name 

Cause 

The system is unable to expand the old file name. The additional information 
line indicates a sltln error. 

Action 

See additional information code in your Commands Reference Manual. 

ORA-7379 

sfcmf: New file exists 

Cause 

There was an attempt to create a new database file with an existing file name. 
This could destroy an existing database file. 

Action 

Check the file name. Verify that the new file does not already exist. If it does, 
specify a different name for the new database file. 

ORA-7380 

sfcmf: Translation error, unable to expand old file name 

Cause 

The additional information line indicates a sltln error. 

Action 

The additional information contains the error number from sltln. See additional 
information code in your Commands Reference Manual. 

ORA-7381 

sfccf: Translation error, unable to expand file name 

Cause 

The additional information line indicates a sltln error. 

Action 

See additional information code in your Commands Reference Manual. 

ORA-7382 

sfifi: Translation error, unable to expand file name 

Cause 

The additional information line indicates a sltln error. 

Action 

See additional information code in your Commands Reference Manual. 
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ORA-7383 

sfgfs: Seals do not match 

Cause 

The function was called with an invalid argument. 

Action 

Probable internal Oracle error. Contact Oracle Worldwide Technical Support. 

ORA-7384 

sfgfn: Seals do not match 

Cause 

The function was called with an invalid argument. 

Action 

Probable internal Oracle error. Contact Oracle Worldwide Technical Support. 

ORA-7385 

sfcfi: Seals do not match 

Cause 

The function was called with an invalid argument. 

Action 

Probable internal Oracle error. Contact Oracle Worldwide Technical Support. 

ORA-7386 

sfrfb: Seals do not match 

Cause 

The function was called with an invalid argument. 

Action 

Probable internal Oracle error. Contact Oracle Worldwide Technical Support. 

ORA-7387 

sfwfb: Seals do not match 

Cause 

The function was called with an invalid argument. 

Action 

Probable internal Oracle error. Contact Oracle Worldwide Technical Support. 

ORA-7388 

sfccf: Reuse specified, but file doesn't exist 

Cause 

The reuse option was used to create a database statement, but the file to reuse 
does not exist. 

Action 

Either verify that the file to be reused exists, or do not use the reuse option. 

ORA-7389 

sfccf: Open error, unable to open file to reuse 

Cause 

The open system call returned an error. 

Action 

See additional information code in your Commands Reference Manual. 

ORA-7390 

sftopn: Translate error, unable to translate file name 

Cause 

An error occurred while expanding a file name. The additional information line 
returns the error generated in the translation routine. 

Action 

See additional information code in your Commands Reference Manual. 

ORA-7391 

sftopn: Fopen error, unable to open text file 

Cause 

The fopen library routine returned an error. 

Action 

Verify that the files exist and that you have the correct permissions. 


7-82 Oracle7 for UNIX 











ORA-7392 

sftcls: Fclose error, unable to close text file 

Cause 

The fclose library routine returned an error. 

Action 

Possible internal Oracle error. Contact Oracle Worldwide Technical Support. 

ORA-7393 

sfccf: File mismatch. Trying to reuse a file with different size 

Cause 

Either the logical block size does not match, or the file size does not match. 

Action 

Verify that the file size and logical block size are correct. Run dbfsize to 
determine file size. 

ORA-7394 

sfccf: Trying to reuse a file with a different block size 

Cause 

Block sizes do not match. 

Action 

Run dbfsize to determine block size. 

ORA-7395 

sfccf: Function called with illegal option 

Cause 

The function was called with an invalid parameter. 

Action 

Possible internal Oracle error. Contact Oracle Worldwide Technical Support. 

ORA-7396 

sfccf: Lseek error, unable to seek to beginning of reuse file 

Cause 

The lseek system call returned an error. 

Action 

See additional information code in your Commands Reference Manual. 

ORA-7397 

sfccf: Read error, unable to read header block of file 

Cause 

The read system call returned an error. 

Action 

See additional information code in your Commands Reference Manual. 

ORA-7398 

sfccf: Invalid header information, file is not a valid database file 

Cause 

You are trying to use a non-database file as a database file. 

Action 

Verify that the file you are using is a database file. 

ORA-7399 

sfccf: File exists 

Cause 

You are trying to create a database file, but a file by that name already exists. 

Action 

Verify that the name of the file is correct. If it is correct, use the reuse option. 

ORA-7400 

slemtr: translated name for the message file is too long 

Cause 

The name for the message file overflows the internal buffer. 

Action 

Try making the complete path-name of the message file shorter by reorganizing 
the directory hierarchy. 
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ORA-7401 

sptrap: cannot restore user exception handlers 

Cause 

The system failed to restore user exception handlers. 

Action 

Check the error number and sercose[0] for the signal number that failed. 

ORA-7402 

sprst: cannot restore user signal handler 

Cause 

The system failed to restore user signal handlers. 

Action 

Check the error number and sercoselO] for the signal number that failed. 

ORA-7403 

sfanfy: db_writers parameter not valid 

Cause 

The db_writers parameter in init.ora exceeds the system-dependent maximum 
or is less than 0. 

Action 

Change the db_writers parameters in init.ora. 

ORA-7404 

sfareq: Time-out occurred waiting for request to complete 

Cause 

The master database writer timed out waiting for a write or close to complete. 
One of the database writers may have stopped running. 

Action 

Check all database writer trace files. Shut down the database and try to warm 
start. 

ORA-7405 

sfcfi: Close failed in one of the database writers 

Cause 

One of the database writer processes got an error when closing a file. 

Action 

Check the error number in all database writer trace files. 

ORA-7406 

slbtpd: invalid number 

Cause 

An impossible request for binary to decimal conversion was made. 

Action 

This conversion cannot be performed. 

ORA-7407 

slbtpd: invalid exponent 

Cause 

An impossible request for binary to decimal conversion was made. 

Action 

This conversion cannot be performed. 

ORA-7408 

slbtpd: Overflow while converting to packed decimal 

Cause 

An impossible request for binary to decimal conversion was made. 

Action 

This conversion cannot be made. 

ORA-7409 

slpdtb: invalid packed decimal nibble 

Cause 

An impossible request for decimal to binary conversion was made. 

Action 

This conversion cannot be performed. 
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ORA-7410 

slpdtb: Number too large for supplied buffer 

Cause 

An impossible request for decimal to binary conversion was made. 

Action 

This conversion cannot be performed. 

ORA-7411 

slgfn: Full pathname too big for supplied buffer 

Cause 

The supplied buffer is not big enough to hold the full pathname. 

Action 

The construction of the full pathname cannot be performed. Shorten pathname. 

ORA-7412 

sfaslv: Error getting entry in asynchronous write array 

Cause 

One of the database writer processes could not locate its entry in the SGA. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-7413 

sfcopy: Allocation of memory buffer failed 

Cause 

The destination file supplied to sfcopy has a different logical block size than the 
source file. 

Action 

Internal error. Contact Oracle Worldwide Technical Support. 

ORA-7414 

sfcopy: Allocation of memory buffer failed 

Cause 

MallocO failed to allocate the temporary buffer for copying data from the source 
file to the destination file. 

Action 

System has run out of heap space. Relocate the SGA to a higher address. See the 
"Oracle System Architecture" chapter for information on relocating the SGA. 

ORA-7415 

slpath: Allocation of memory buffer failed 

Cause 

MallocO failed to allocate buffer for storing ORACLE_PATH. 

Action 

System has run out of heap space. Relocate the SGA to a higher address. See the 
"Oracle System Architecture" chapter for information on relocating the SGA. 

ORA-7416 

slpath: Pathname construction failed, lack of output buffer space 

Cause 

The slpath routine is given a maximum length buffer to expand the name into. 
An overflow of this buffer occurred. 

Action 

Possible internal error. Check the output buffer length stored in sercose[0] and 
constructed pathname length in sercose[l]. Create a shorter name. 

ORA-7417 

sfareq: One or more database writers not active 

Cause 

One or more of the database writer processes is no longer running. 

Action 

Check the trace files for the database writers. Shut down the database and try to 
warm start. 
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ORA-7418 

sfareq: Database writer got error in timing function 

Cause 

An error occurred when the database writer called the system timing function. 

Action 

Check the database writer trace file. Shut down the database and try to warm 
start. 

ORA-7419 

sfareq: Database writer got error in timing function 

Cause 

An error occurred when the database writer called the system timing function. 

Action 

Check the database writer trace file. Shut down the database and try to warm 
start. 

ORA-7420 

sfccf: Illegal file type 

Cause 

Cannot initialize a file of illegal file type. 

Action 

Verify that your file name is correct. The supported types are raw devices and 
regular files. 

ORA-7421 

sfcopy: failed to read from the source file during copy 

Cause 

An error occurred when reading from the source file. 

Action 

Check additional information for the error occurring during read. 

ORA-7422 

sfcopy: failed to write to the destination file during copy 

Cause 

An error occurred when writing to the destination file. 

Action 

Check additional information for the error occurring during write. 

ORA-7423 

sfrfb: read failed because buffer was not aligned properly 

Cause 

The I/O buffer was not aligned to the correct boundary. 

Action 

Internal error. Keep the trace file and contact Oracle Worldwide Technical 
Support. 

ORA-7424 

sfwfb: write failed because buffer was not aligned properly 

Cause 

The I/O buffer was not aligned to the correct boundary. 

Action 

Internal error. Keep the trace file and contact Oracle Worldwide Technical 
Support. 

ORA-7425 

sdpri: error %s in translating dump file location 

Cause 

An Oracle error occurred when translating the location of the dump file. 

Action 

Check the Oracle error code. 

ORA-7426 

spstp: cannot obtain the location of dbs directory. 

Cause 

An oracle error occurred when translating the location of the dbs directory. 

Action 

Check additional information for the error returned from sltln. 
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ORA-7427 

Cause 

Action 

ORA-7428 

Cause 

Action 

ORA-7429 

Cause 

Action 


ORA-7430 

Cause 

Action 

ORA-7446 

Cause 

Action 

ORA-7447 

Cause 

Action 

ORA-7448 

Cause 

Action 

ORA-7449 

Cause 

Action 


spstp: cannot change directory to dbs. 

Chdir system call returned an error. Possible permission problems. 

Check additional information for the operating system code, 
smsgsg: ftokO returned error in calculating key for sga. 
the ftokO library call failed in smsgsgO. 

Verify that the $(ORACLE_HOME}/sgadef${ORACLE_SID|.dbf file exists. If it 
does, this is a possible system failure. Perhaps System V compatibility is not 
enabled. The additional information indicates the segment in which the error 
occurred. 

smsgsg: shmgetO failed to get segment. 

A shared memory segment used for all part of the SGA could not be retrieved. 

Use the system error number in the error message to determine why the 
segment could not be retrieved. If it does not exist, shut down the database 
using the "abort" option, and then restart it. If the get failed because the 
permissions are incorrect, make sure that the ownership of the oracle executable 
is the same as that on the shared memory segment. 

smsgsg: calculated and stored keys do not match. 

When smsgsgO gets a segment, it re-calculates the key for the segment. It then 
compares the value against the value stored in the sgadef file. If they do not 
match, the file is probably corrupt. 

Shut down the database and restart it. 

sdnfy: bad value '%s' for parameter %s. 

The directory specified as the value for the stated parameter could not be used. 
Make sure the directory you have specified is a valid directory/file specification, 
ssarena: usinit failed. 

Oracle failed to create a shared arena file. 

Use sercerrno field to determine cause of failure, 
ssarena: maximum number of shared arenas exceeded. 

Oracle attempted to create more shared arena files than permitted. 

Raise the value for max_arena in init.ora. 
sc: usnewlock failed. 

Oracle failed to acquire a shared arena lock. 

Check result code in sercerrno to determine the cause of failure. 
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ORA-7450 

smslsg: vm_mapmem error, unable to create shared memory 

Cause 

Error in vm_mapmem. Failed to create SGA as a single shared memory 
segment. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-7451 

smslsg: shared memory attach address incorrect 

Cause 

The vm_mapmem system call attached the SGA at an incorrect location. 

Action 

Verify that the SGA attach address is valid. Check sercose[0] for the address. 
Contact Oracle Worldwide Technical Support. 

ORA-7452 

smslsg: Failed to change SGA inheritance 

Cause 

The vmjnherit system call failed to change the inheritance of the SGA. 

Action 

Check result code returned in sercosefO]. Possible operating system failure. 

ORA-7453 

smsmat: vm_mapmem error, unable to create shared memory. 

Cause 

Error in vm_mapmem. Failed to create a segment of the SGA. 

Action 

Check result code returned in sercerrn[0]. Contact Oracle Worldwide Technical 
Support. 

ORA-7454 

smsmat: Shared memory attach address incorrect. 

Cause 

The vm_mapmem system call attached an SGA segment at in incorrect location. 

Action 

Verify that the SGA attach address is valid. Check result code returned in 
sercose[0J. Contact Oracle Worldwide Technical Support. 

ORA-7455 

smsmat: Failed to change SGA segment inheritance. 

Cause 

The vm_inherit system call failed to change the inheritance of a segment of the 
SGA. 

Action 

Check result code returned in sercerrno. Possible operating system failure. 
Contact Oracle Worldwide Technical Support. 

ORA-7456 

smsmax: Cannot get cluster size. 

Cause 

The cluster_stat system call failed to return status for the cluster. 

Action 

Check result code in sercoselOJ. Possible operating system failure. Contact 
Oracle Worldwide Technical Support. 

ORA-7457 

smsdes: Name translation failure of sgadef.dbf file name 

Cause 

Unable to expand out ?/dbs/sgadef.dbf file name. 

Action 

Verify ORACLE HOME and ORACLE SID are properly set. Check error 
number returned from sltln in sercoselO]. Contact Oracle Worldwide Technical 
Support. 
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ORA-7458 

Cause 

Action 

ORA-7459 


smsdes: Close error, unable to close sgadef.dbf 

An error occurred in close, while closing the file ?/dbs/sgadef.dbf 

Verify that sgadef.dbf file has been deleted. If it hasn't, delete it. Possible 
operating system error. Shut down and restart the database. 

smsvmfcre: Name translation failure of sgdef.dbf file name 


Cause 

Action 


ORA-7460 

Cause 

Action 

ORA-7461 

Cause 

Action 

ORA-7462 

Cause 

Action 

ORA-7463 

Cause 

Action 

ORA-7464 

Cause 

Action 


Unable to expand out ?/dbs/sgadef.dbf file name. 

Verify ORACLE_HOME and ORACLE_SID are properly set. Check error 
number returned from sltln in sercose[0l. See the "Oracle System Architecture 
chapter for further information on ORACLE_HOME and ORACLE_SID. 

smsvmfcre: sgadef.dbf already exists when creating SGA 

The file ?/dbs/sgadef.dbf should not exist when trying to create the SGA; 
otherwise a running instance could be halted. 

Verify that the database is really down, and delete the sgadef.dbf file. This 
should only happen when the machine crashed with the database up. 

smsvmfcre: Failure in creating sgadef.dbf file. 

Open failed when trying to create the file ?/dbs/sgadef.dbf. 

Verify permissions on the $ORACLE_HOME /dbs directory. 

smsget: Open error when opening sgadef.dbf file 

Unable to expand out ?/dbs/sgadef.dbf file name. 

Verify ORACLE_HOME and ORACLE_SID are properly set. Check error 
number returned from sltln in sercoselO]. See the "Oracle System Architecture 
chapter for further information on ORACLE_HOME and ORACLE_SID. 

smsget: Open error when opening sgadef.dbf file. 

Open failed when opening the file ?/dbs/sgadef.dbf 

Check error number. Possible permission problem. Verify that the file 
?/dbs/sgadef.dbf exists. Shut down and restart the database. 

smsget: vm_mapmem error when trying to attach SGA. 

The vm_mapmem system call failed when attempting to attach a segment of the 
SGA. 

Check result code returned in sercerrno. SGA segment number returned in 
sercosell]. Contact Oracle Worldwide Technical Support. 
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ORA-7465 

smsget: Shared memory attach address incorrect. 

Cause 

The vm_mapmem system call attached an SGA segment at an incorrect location. 

Action 

Verify that the segment exists, and the SGA attach address is valid. Contact 
Oracle Worldwide Technical Support. 

ORA-7466 

smsget: Failed to change SGA segment inheritance. 

Cause 

The vm_inherit system call failed to change the inheritance of a segment of the 
SGA. 

Action 

Check result code returned in sercerrno. Possible operating system failure. 

ORA-7467 

smsget: Close error, unable to close sgadef.dbf file 

Cause 

An error in close, while closing the file ?/dbs/sgadef.dbf. 

Action 

Check result code returned in sercerrno. Possible operating system failure. 

ORA-7468 

spwat: mset error, unable to set semaphore 

Cause 

The mset routine returned an error. Semaphore may not exist. 

Action 

Check result code in sercerrno. Semaphore returned in sercoselO]. Contact 
Oracle Worldwide Technical Support. 

ORA-7469 

sppst: mclear error, unable to clear semaphore 

Cause 

The mclear routine returned an error. Semaphore may not exist. 

Action 

Check result code in sercerrno. Semaphore number returned in sercoselO]. 
Contact Oracle Worldwide Technical Support. 

ORA-7470 

snclget: Cannot get cluster number 

Cause 

The cluster_status system call failed to get status information for the current 
cluster. 

Action 

Check result code in sercoselO]. Possible operating system failure. Contact 
Oracle Worldwide Technical Support. 

ORA-7471 

snclrd: Name translation error of sgadef.dbf file name 

Cause 

Unable to expand out ?/dbs/sgadef.dbf file name. 

Action 

Verify ORACLE_HOME and ORACLEJ3ID are properly set. Check error 
number returned from sltln in sercoselO]. See the "Oracle System Architecture " 
chapter for further information on ORACLE_HOME and ORACLE_SID. 

ORA-7472 

snclrd: Open error when opening sgadef.dbf file 

Cause 

Open failed when opening the file ?/dbs/sgadef.dbf 

Action 

Check error number. Possible permission problem. Verify that the file 
?/dbs/sgsadef@.dbf exists. Shut down and restart the database. 
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ORA-7473 snclrd: Read error when trying to read sgadef.dbf file 


Cause 

Read had an error when reading sgadef.dbf file 

Action 

Verify file exists, and is correct size. Contact Oracle Worldwide Technical 
Support. 

ORA-7474 

snclrd: Close error, unable to close sgadef.dbf file 

Cause 

An error occurred in close, while closing the file ?/dbs/sgadef.dbf. 

Action 

Check error number. Possible operating system error. Contact Oracle 
Worldwide Technical Support. 

ORA-7475 

slsget: Cannot get vm statistics 

Cause 

The vm_statistics system call failed to get virtual memory statistics. 

Action 

Check result code in sercerrno. Possible operating system failure. Contact 
Oracle Worldwide Technical Support. 

ORA-7476 

slsget: Cannot get mapped memory statistics 

Cause 

The vm_mapmem system call failed to get mapped memory statistics. 

Action 

Check result code in sercerrno. Possible operating system failure. Contact 
Oracle Worldwide Technical Support. 

ORA-7477 

scgcmn: lock manager not initialized 

Cause 

Lock manager must be initialized before converting locks. 

Action 

ORA-7478 

Check result code in sercerrno. Possible lock manager failure. 

scgcmn: cannot get lock status 

Cause 

lm_stat_lock failed. 

Action 

Check result code in sercerrno. Possible lock manager failure. 

ORA-7479 

scgcmn: cannot open or convert lock 

Cause 

lm_open or lm_open_convert failed. 

Action 

Check result code in sercerrno. Possible lock manager failure 

ORA-7480 

snchmod: cannot change permissions on ?/dbs/sgalm.dbf 

Cause 

When creating an instance, snlmini could not change the permissions on 

?/dbs/sgalm.dbf 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-7481 

snlmatt: cannot attach to lock manager instance 

Cause 

lm_attach failed to attach to lock manager instance. 

Action 

Check result code in sercererno. Possible lock manager failure. 
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ORA-7482 

snlmini: cannot create lock manager instance 

Cause 

lm_create failed to create lock manager instance. 

Action 

Check permissions on ?/dbs, and remove ?/dbs/sgalm.dbf if it exists, then retry. 

ORA-7483 

snlkget: cannot convert (get) lock 

Cause 

lm_convert failed to convert (get) lock. 

Action 

Check result code in sercerrno. Possible lock manager failure. 

ORA-7484 

snlkput: cannot convert (put) lock 

Cause 

lm_convert failed to put lock value. 

Action 

Check result code in sercerrno. Possible lock manager failure. 

ORA-7485 

scg_get_inst: cannot open instance number lock 

Cause 

lm_open failed. 

Action 

Check result code in sercerrno. Possible lock manager failure. 

ORA-7486 

scg_get_inst:cannot convert (get) instance number lock 

Cause 

lm_convert failed to get lock value. 

Action 

Check result code in sercerrno. Possible lock manager failure. 

ORA-7487 

scg_init_lm: cannot create lock manager instance 

Cause 

lm_create failed. 

Action 

Check result code in sercerrno. Possible lock manager failure. 

ORA-7488 

scgrcl: lock manager not initialized 

Cause 

Lock manager must be initialized before releasing locks. 

Action 

Check result code in sercerrno. Possible lock manager failure. 

ORA-7489 

scgrcl: cannot get lock status 

Cause 

lm_stat_lock failed during lock release/cancel. 

Action 

Check result code in sercerrno. Possible lock manager failure. 

ORA-7490 

scgrcl: cannot convert lock 

Cause 

lm_convert failed during lock release/cancel. 

Action 

Check result code in sercerrno. Possible lock manager failure. 

ORA-7491 

scgrcl: cannot cancel lock request 

Cause 

lm_cancel failed during lock release/cancel. 

Action 

Check result code in sercerrno. Possible lock manager failure. 
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ORA-7492 

scgrcl: cannot close lock 

Cause 

lm_close failed during lock release/cancel. 

Action 

Check result code in sercermo. Possible lock manager failure. 

ORA-7493 

scgrcl: lock manager error 

Cause 

An error was encountered releasing the lock. 

Action 

Check result code in sercerrno. Possible lock manager failure. 

ORA-7494 

scgcm: unexpected error 

Cause 

Unknown or unexpected error code. 

Action 

Check result code in sercerrno. Possible lock manager failure. 

ORA-7495 

spwat: lm_wait failed 

Cause 

lm_wait failed. 

Action 

Check result code in sercerrno. Possible lock manager failure. 

ORA-7496 

sppst: lm_post failed 

Cause 

lm_post failed 

Action 

Check result code in sercerrno. Possible lock manager failure. 

ORA-7497 

sdpri: cannot trace file '%s'; errno = %s 

Cause 

The trace file cannot be created for writing. 

Action 

Check if the dump directory exists and whether it is writeable. 

ORA-7498 

spstp: Unable to open /dev/resched 

Cause 

The rescheduling driver /dev/resched is not found or is not working properly. 

Action 

Check installation of the Oracle rescheduling driver in the AIX kernel. 

ORA-7499 

spglk: Cannot reschedule 

Cause 

The rescheduling driver /dev/resched is not open. Internal error. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-7541 

sfifi: Cannot identify zero-length file. 

Cause 

Cannot use the specified file since it is zero-length. 

Action 

Examine each of the specified files to determine which one is zero-length and 
replace that with a file that is not zero-length. 
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ORA-7543 

sfrfb: Cannot read from zero-length file. 

Cause 

Cannot read any logical blocks from the specified file since it is zero-length. 

Action 

Examine each of the specified files to determine which one is zero-length and 
replace that one with a file that is not zero-length. 

ORA-7544 

sfqio: asynchronous I/O not completed successfully 

Cause 

The asynchronous I/O being performed did not complete successfully. 

Action 

Examine the additional messages and refer to VMS documentation. 

ORA-7556 

sfotf: $create error 

Cause 

VMS system service $CREATE failed. 

Action 

Examine system error message and refer to VMS documentation. 

ORA-7557 

ssfctf: illegal logical block size specified for tape file 

Cause 

An illegal logical block size was specified for the tape file. 

Action 

This is an internal error; please contact Oracle Worldwide Technical Support. 

ORA-7558 

ssfctf: $create error 

Cause 

VMS system service $CREATE failed. 

Action 

Examine system error message and refer to VMS documentation. 

ORA-7559 

sfdone: asynchronous I/O not completed successfully 

Cause 

The asynchronous I/O being performed did not complete successfully. 

Action 

Internal error;. Contact Oracle Worldwide Technical Support. 

ORA-7641 

smscre: Unable to use the system pagefile for the SGA 

Cause 

The system global area (SGA) backing file could not be allocated using the 
system pagefile because the system-wide limit on global pages has been 
exceeded. 

Action 

Either increase the VMS system parameter GBLPAGFIL or use a disk file as the 
SGA backing file. 

ORA-7721 

scgcm: not enough OS resource to obtain system enqueue 

Cause 

A call to sys$enq returned an error indicating that the operating system lacked 
the resources necessary to create a lock. This is caused by the message 

SS$_EXENQLM or SS$_INSFMEM. 

Action 

Free up some of the required resource to allow the creation of the required lock. 
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ORA-7861 sfqio: cannot write to file opened in read-only mode 

Cause A write operation was attempted on a file opened in read-only mode. 

Action Do not open the file in read-only mode. 

ORA-7862 sfqio: cannot expand the file 

Cause The size of a file could not be expanded. 

Action Check for additional error messages and contact Oracle Worldwide Technical 
Support. 

ORA-7880 sdopnf: internal error 


Cause 

Action 

ORA-9700 

Cause 

Action 

ORA-9701 

Cause 

Action 

ORA-9702 

Cause 

Action 

ORA-9703 

Cause 

Action 

ORA-9704 

Cause 

Action 


A list of all files open by this process could not be obtained. 

This is an internal error. Contact Oracle Worldwide Technical Support, 
sclin: maximum number of latches exceeded 
Oracle wants to use more latches than available. 

Increase init.ora parameter latch_pages or decrease the amount of shared 
memory you are using. 

scnfy: maximum number of processes exceeded 

PROCESSES init.ora parameter exceeded. 

Decrease the PROCESSES parameter and restart. 

sem_acquire: cannot acquire latch semaphore 

The semaphore used for accessing latches could not be seized. 

Send trace file to Oracle Worldwide Technical Support along with information 
on reproducing the error. 

sem_release: cannot release latch semaphore 

The semaphore used for accessing latches could not be released. 

Send trace file to Oracle Worldwide Technical Support along with information 
on reproducing the error. 

sstascre: ftok error in creating test and set pages 
The ftok() library call failed in sstastcre(). 

Verify that tasdef@.dbf file exists. If it does, then this is a possible system 
failure. Perhaps System V compatibility is not enabled. 
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ORA-9705 

spcre: cannot initialize latch semaphore 

Cause 

The semaphore used for accessing latches could not be initialized. 

Action 

Send trace file to Oracle Worldwide Technical Support along with information 
on reproducing the error. 

ORA-9706 

slsget: get_process_stats error 

Cause 

get_process_stats system call returned an error. Possible operating system error. 

Action 

Check additional information returned. Look for information in operating 
system reference. Contact Oracle Worldwide Technical Support. 

ORA-9707 

sfccf: maximum length of ORACLE_SID exceeded 

Cause 

Too many characters in the ORACLE_SID string. 

Action 

Rename the ORACLE_SlD to a string of up to the maximum number of 
characters specified for your system. 

ORA-9708 

soacon: failed to bind socket to port 

Cause 

The bind system call failed on the socket. 

Action 

Check additional information for operating system error. Try connecting again. 

ORA-9709 

soacon: failed to accept a connection 

Cause 

The accept system call failed on the socket. 

Action 

Check additional information for operating system error. Try connecting again. 

ORA-9710 

soarcv: buffer overflow 

Cause 

The internal buffer is not big enough to hold the message read. 

Action 

Internal error. Contact Oracle Worldwide Technical Support. 

ORA-9711 

orasrv: log archiver already connected 

Cause 

An existing connection has already been made from log archiver to orasrv. 

Action 

Stop trying to connect. 

ORA-9712 

orasrv: log archiver already connected 

Cause 

An existing connection has already been made from log archiver to orasrv. 

Action 

Stop trying to connect. 

ORA-9713 

soadum: cannot do log archiving to tape 

Cause 

You are missing the necessary communication driver for the log archiver to 
communicate with the console process. 

Action 

Install the appropriate communication driver. 
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ORA-9714 

Two Task interface: cannot obtain puname 

Cause 

The txipc driver cannot obtain the name of the PU. Possible operating system 
error. 

Action 

Check if the PUs are named (consistent). 

ORA-9715 

orasrv: cannot obtain puname 

Cause 

Orasrv cannot obtain the name of the PU. Possible operating system error. 

Action 

Check if the PUs are named (consistent). 

ORA-9716 

kslcll: unable to fix in-flux lamport latch 

Cause 

One Oracle process died while still holding a lamport latch. 

Action 

Exit (kill) all Oracle user processes. Shutdown (abort) and restart Oracle Server 
kernel. 

ORA-9717 

osnsui: maximum number of user interrupt handlers exceeded 

Cause 

The internal limit on the number of user interrupt handlers has been exceeded. 

Action 

Reduce the number of simultaneous logons or reduce the number of user 
interrupt handlers. 

ORA-9718 

osnui: cannot set up user interrupt handler 

Cause 

MallocO failed to allocate space to hold user interrupt handler. 

Action 

Possible memory resource shortage. 

ORA-9719 

osncui: invalid handle 

Cause 

The handle passed to osncui is out of the valid range. 

Action 

Use a valid handle. 

ORA-9740 

slsget: cannot get virtual memory region statistics 

Cause 

The vm_region system call failed to get virtual memory region statistics. 

Action 

Check return code in sercerrno. Possible operating system failure. 

ORA-9741 

spwat: error waiting for a post 

Cause 

The msg_receive system call returned an error. Internal error. 

Action 

Check return code in sercerrno. Possible operating system failure. 

ORA-9742 

sppst: error during a post 

Cause 

The msg_send system call returned an error. Internal error. 

Action 

Check return code in sercerrno. Port name is returned in sercoselO]. 
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ORA-9743 

smscre: could not attach shared memory 

Cause 

The mmap or write system call returned an error. Internal error. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-9744 

smsget: mmap returned an error 

Cause 

The mmap system call returned an error. Internal error. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-9745 

smscre: vm_allocate error, unable to create shared memory 

Cause 

Error in system call vm_allocate. Failed to create the SGA as a single shared 
memory segment. 

Action 

Check result code returned in sercerrno. Verify that the SGA attach address is 
valid. 

ORA-9746 

smscre: shared memory attach address incorrect 

Cause 

The vm_allocate system call attached the SGA at an incorrect location. 

Action 

Verify that the SGA attach address is valid. 

ORA-9747 

pw_detachPorts: server call pws_detach failed 

Cause 

The call pws_detach to (Oracle helper) failed. 

Action 

Make sure the server is still active. Check the error code returned in sercerrno 
and look for error messages in the server log file. 

ORA-9748 

pws_look_up: fork failed 

Cause 

The pws_look_up call could not fork the (Oracle helper) process. 

Action 

Verify that there are enough system resources to support another process. The 
user or system process limit may have been exceeded or the amount of free 
memory or swap space may be temporarily insufficient. 

ORA-9749 

pws_look_up: port lookup failure 

Cause 

The pws_look_up could not find a port to (Oracle helper). 

Action 

Make sure the (Oracle helper) server has been started correctly by pws_look_up 
and that the network name server is still running. 

ORA-9750 

pw_attachPorts: port_rename failed 

Cause 

The port_rename system call failed. Possible internal error. 

Action 

Check return code in sercerrno, report to Oracle Worldwide Support. 
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ORA-9751 

pw_attachPorts: server call pws_attach failed 

Cause 

The call pws_attach to (Oracle helper) failed. 

Action 

Make sure the server is still active. Check the error code returned in sercerrno 
and look for error messages in the server log file. 

ORA-9752 

pw_attachPorts: port_allocate failed 

Cause 

The port_allocate system call failed. Possible resource exhaustion. 

Action 

Check return code in sercerrno, report to Oracle Worldwide Technical Support. 

ORA-9753 

spwat: invalid process number 

Cause 

Function was passed an invalid Oracle process ID. 

Action 

Internal error. Additional information indicates the invalid process ID. 

ORA-9754 

sppst: invalid process number passed to sppst 

Cause 

Function was passed an invalid Oracle process ID. 

Action 

Internal error. Contact Oracle Worldwide Technical Support. 

ORA-9755 

osngpn: port allocation failure 

Cause 

The port_allocate system call failed. 

Action 

Possible system resource shortage; check the error code in sercermo. 

ORA-3756 

osnpns: no port in the name server 

Cause 

The osnpns could not find the given named port in the name server. 

Action 

Check the error code in sercerrno. Make sure the shadow process and network 
name server are still running. 

ORA-9757 

osnipn: port allocation failure 

Cause 

The port_allocate system call failed. 

Action 

Possible system resource shortage; check the error code in sercerrno. 

ORA-9758 

osnipn: could not check port in name server 

Cause 

The netname_check_in fall failed. 

Action 

Check the error code in sercerrno. Make sure the network name server is 
running. 

ORA-9759 

osnsbt: bad message received 


Cause The msg receive system call failed or received a bad message. 
Action Internal error. Report the error code returned in sercermo. 
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ORA-9760 

osnpui: cannot send break message 

Cause 

The pipe driver could not send a break message to the Oracle shadow process 
break thread. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-9761 

pw_destroyPorts: server call pws_stop_instance failed 

Cause 

The call pws_stop_instance to (Oracle helper) failed. 

Action 

Make sure the server is still active. Check the error code returned in sercerrno 
and look for error messages in the server file log file. 

ORA-9762 

sNeXT_instanceName: translation error 

Cause 

A failure was detected while translating the value of ORACLE_SID- 

Action 

Make sure ORACLE_SID is defined and that it is of legal length. 

ORA-9763 

osnmpx: send/receive error exchanging Mach ports 

Cause 

The Mach driver failed to exchange port information with the other side of the 
connection. Either msg_send (sercose[0]==l) or msg_receive (sercose[01==2) 
failed. 

Action 

Check return code in sercerrno. Make sure both sides of the connection are still 
running. 

ORA-9764 

osnmop: access error on oracle executable 

Cause 

The Mach driver could not access the oracle executable. 

Action 

Check the permissions on the oracle executable and each component of the 
$ORACLE_HOME/bin path. 

ORA-9765 

osnmop: fork failed 

Cause 

The Mach driver could not fork the oracle shadow process. 

Action 

Verify that there are enough system resources to support another process. The 
user or system process limit may have been exceeded, or the amount of free 
memory or swap space may be temporarily insufficient. 

ORA-9766 

osnmop: buffer allocation failure 

Cause 

The Mach driver failed to allocate enough vm space for its I/O buffers. 

Action 

Decrease the value of buffer size parameter in the Two-Task driver hoststring. 

ORA-9767 

osnmfs: bad return code from msg_send 

Cause 

The msg_send system call failed while flushing the Mach driver's send buffer. 

Action 

Internal error. Contact Oracle Worldwide Technical Support. 


7-100 Oracle7 for UNIX 










ORA-9768 

Cause 

Action 

ORA-9769 

Cause 

Action 

ORA-9770 

Cause 

Action 

ORA-9771 

Cause 

Action 

ORA-9772 

Cause 

Action 

ORA-9773 

Cause 

Action 

ORA-9774 

Cause 

Action 

ORA-9775 

Cause 

Action 


osnmgetmsg: could not read a message 

The msg_receive system call returned a failure code while waiting for a message 
in the Mach driver. 

Internal error. Contact Oracle Worldwide Technical Support, 
osnmbr: cannot send break message 

The Mach driver could not send a break message to the Oracle shadow process 
break thread. 

Internal error. Contact Oracle Worldwide Technical Support. 

pws_look_up: translation failure 

The pws_look_up routine failed to translate the name of the (Oracle helper) 
executable. 

Make sure ORACLE_SID and ORACLE HOME are set and correct. Additional 
information gives the translation error code. 

osnmwrtbrkmsg: bad return code from msg_send 

The msg_send system call failed while sending a Mach driver break. 

Internal error. Contact Oracle Worldwide Technical Support. 

osnpmetbrkmsg: message from host had incorrect message type 

The Mach driver received a message having an unrecognizable message type. 

Internal error. Contact Oracle Worldwide Technical Support. 

osnmgetdatmsg: message from host had incorrect message 

The Mach driver received a message having an unrecognizable message type. 

Internal error. Contact Oracle Worldwide Technical Support. 

osnmui: cannot send break message 

The Mach driver could not send a break message to the oracle shadow process 
break thread. 

Internal error. Contact Oracle Worldwide Technical Support. 

osnmre: reset protocol error 

The Mach two-task driver could not reset the connection. 

Internal error. Contact Oracle Worldwide Technical Support. 
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ORA-9776 

Cause 

Action 

ORA-9777 

Cause 

Action 


pws_look_up: access the (ORACLE helper) executable 

The pws_look_up call could not access the (Oracle helper) executable. 

Check the permissions on the (Oracle helper) executable and each component of 

the $ORACLE_HOME/bin path. 

osnpbr: cannot send break message 

The pipe driver could not send a break message to the oracle shadow process 
break thread. 

Internal error. Contact Oracle Worldwide Technical Support. 
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ORA-9778 

snynfyport: failure allocation the notify port 

Cause 

The routine failed to allocate or set the task's notify port. 

Action 

Possible operating system error. Contact Oracle Worldwide Technical Support. 

ORA-9779 

snyGetPort: failure to allocate a port 

Cause 

The port_allocate system call failed; system resources might be exhausted. 

Action 

Possible operating system error. Contact Oracle Worldwide Technical Support. 

ORA-9780 

sfifi: translation error, unable to expand instance name 

Cause 

Additional information indicates sltln error. 

Action 

Check additional information. 

i 

ORA-9781 

sfifi: bad instance name stored in control file 

Cause 

The header block might have been corrupted. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-9782 

sfifi: another instance has the same database mounted 

Cause 

In non-shared disk systems, database cannot be mounted shared. 

Action 

Shut down the other Oracle instance and try again. The name of the other 
instance was dumped to the trace file. 

ORA-9783 

sfifi: cannot determine if another instance has mounted the same database 

Cause 

Because of permission problems, could not check if the other instance was up. 

Action 

Check errno. Additional information indicates error in closing file. 

ORA-9784 

sfifi: lseek error, unable to seek to beginning of file 

Cause 

Lseek system call returned an error. 

Action 

Check errno. Additional information indicates error in closing file. 

ORA-9785 

sfifi: write error, unable to write header block 

Cause 

Write system call returned an error. 

Action 

Check errno. 

ORA-9786 

sllfop: open error, unable to open file 

Cause 

Open system call returned an error. 

Action 

Check errno. 

ORA-9787 

sllfop: unrecognizable processing option, incorrect format 

Cause 

Processing option passed is of incorrect format. 

Action 

Consult your ICG for permissible formats. 
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ORA-9788 

sllfrb: unable to read file 

Cause 

Read system call returned an error. 

Action 

Check errno. Verify file exists. 

ORA-9789 

sllfsk: unable to read file 

Cause 

Read system call returned an error. 

Action 

Check errno. Verify file exists. 

ORA-9790 

sllfcf: unable to close file 

Cause 

Close system call returned an error. 

Action 

Check errno. 

ORA-9791 

slembdf: translation error, unable to translate error file name 

Cause 

Additional information indicates error returned from sltln. 

Action 

Check additional information. 

ORA-9792 

sllfop: cannot allocate read buffer 

Cause 

Malloc system call returned an error. The system might have run out of heap 
space. 

Action 

Check additional information for the operating system error. 

ORA-9793 

szguns: length of user name is greater than the buffer 

Cause 

The length of the name of the user being looked up is longer than size of the 
buffer provided by the calling routine. 

Action 

This is an internal error. Contact Oracle Worldwide Technical Support. 

ORA-9794 

szrbuild: length of role name is greater than buffer 

Cause 

The length of the name of the role being looked up is long than size of the buffer 
provided by the calling routine. 

Action 

This is an internal error. Contact Oracle Worldwide Technical Support. 

ORA-9795 

szebuild: malloc of role structure failed 

Cause 

The allocation of memory for an internal structure used to hold a role descriptor 
failed. 

Action 

Check the UNIX number for a possible operating system failure. 

ORA-9796 

szrbuild: malloc of role name failed 

Cause 

The allocation of memory for an internal buffer used to hold the name of a role 
failed. 

Action 

Check the UNIX number for a possible operating system failure. 
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ORA-9797 szlgmp: failed to get O/S MAV privileges 

Cause The operating system would not allow the retrieval of this process' privileges. 


Action 

Check the UNIX number for a possible operating system failure. If there is no 
error, contact Oracle Worldwide Technical Support. 

ORA-9798 

szlcompare: label comparison failed 

Cause 

The comparison of two binary labels failed. 

Action 

Check the UNIX number for a possible operating system failure. If there is no 
error, contact Oracle Worldwide Technical Support. 

ORA-9799 

szlgfi: file label retrieval failed 

Cause 

Oracle was unable to get a label attached to a file. 

Action 

Check the UNIX number for a possible operating system failure. If there is no 
error, contact Oracle Worldwide Technical Support. 

ORA-9800 

Process sensitivity label retrieval failed. 

Cause 

Oracle was unable to get the sensitivity label for a process. 

Action 

Check the UNIX number for a possible operating system failure. If there is no 
error, contact Oracle Worldwide Technical Support. 

ORA-9801 

Unable to get user ID from connection 

Cause 

Oracle was unable to convert a string representation of a category to its 
corresponding number. 

Action 

Check the UNIX number for a possible operating system failure. Also check the 
"additional information" field for the SQL*Net error. If there is no error, contact 
Oracle Worldwide Technical Support. 

ORA-9802 

Conversion of binary label to string failed. 

Cause 

Oracle was unable to convert a binary label to a string. 

Action 

Check the UNIX number for a possible operating system failure. If there is no 
error, contact Oracle Worldwide Technical Support. 

ORA-9803 

szlgfi: allocation of string buffer failed 

Cause 

A buffer used to hold the name of the file for which a label was obtained could 
not be allocated. 

Action 

Check the UNIX number for a possible operating system failure. If there is no 
error, contact Oracle Worldwide Technical Support. The number of bytes that 
Oracle attempted to allocate is in the "Additional Information" field. 


UNIX Messages and Codes 7-105 








ORA-9804 

class conversion from binary to ORACLE failed 

Cause 

Oracle was unable to convert a class component from binary format to Oracle 
format. 

Action 

Check the UNIX number for a possible operating system failure. If there is no 
error, contact Oracle Worldwide Technical Support. 

ORA-9805 

conversion of category number to string failed 

Cause 

Oracle was unable to translate a category number to its corresponding string 
representation failed. 

Action 

Check the UNIX number for a possible operating system failure. If there is no 
error, contact Oracle Worldwide Technical Support. The category number is 
contained in the "Additional Information" field. 

ORA-9806 

allocation of string buffer failed 

Cause 

A temporary buffer used to hold a class component of a label could not be 
allocated. 

Action 

Check the UNIX number for a possible operating system failure. If there is no 
error, contact Oracle Worldwide Technical Support. The number of bytes that 
Oracle attempted to allocate is in the "Additional Information" field. 

ORA-9807 

szlstl: allocation of string buffer failed 

Cause 

A temporary buffer used to hold a category component of a label could not be 
allocated. 

Action 

Check the UNIX number for a possible operating system failure. If there is no 
error, contact Oracle Worldwide Technical Support. 

ORA-9808 

szlgcl: could not obtain user clearance 

Cause 

Oracle was unable to get a user's clearance level. 

Action 

Check the UNIX number for a possible operating system failure. If there is no 
error, contact Oracle Worldwide Technical Support. 

ORA-9809 

Unable to get user's group ID from connection 

Cause 

Oracle was unable to retrieve the user's group ID number from the SQL*Net 
connection. 

Action 

Check the UNIX number for a possible operating system failure. Also check the 
"additional information" field for the SQL*Net error. If there is no error, contact 
Oracle Worldwide Technical Support. 
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ORA-9810 

Unable to get process ID from connection 

Cause 

Oracle was unable to retrieve the user's process ID number from the SQL*Net 
connection. 

Action 

Check the UNIX number for a possible operating system failure. Also check the 
"additional information" field for the SQL*Net error. If there is no error, contact 
Oracle Worldwide Technical Support. 

ORA-9811 

Unable to initialize package 

Cause 

Oracle was unable to initialize the library used to obtain security information. 

Action 

This is an internal error. Contact Oracle Worldwide Technical Support. 

ORA-9812 

Unable to get user clearance from connection 

Cause 

Oracle was unable to retrieve the user's operating system session clearance from 
the SQL*Net connection. 

Action 

Check the UNIX number for a possible operating system failure. Also check the 
"additional information" field for the SQL*Net error. If there is no error, contact 
Oracle Worldwide Technical Support. 

ORA-9813 

Unable to get directory status 

Cause 

Oracle was unable to determine if a directory is multilevel. 

Action 

Check the UNIX number for a possible operating system error. If there is no 
error, contact Oracle Worldwide Technical Support. 

ORA-9814 

Unable to expand file name 

Cause 

Oracle was unable to expand the name of a file that resides in multilevel 
directory. 

Action 

Check the UNIX number for a possible operating system error. If there is no 
error, contact Oracle Worldwide Technical Support. 

ORA-9815 

File name buffer overflow 

Cause 

The buffer that Oracle uses to hold the expanded name of a too small. 

Action 

This is an internal error. Contact Oracle Worldwide Technical Support. 

ORA-9816 

Unable to set effective privileges 

Cause 

This is an internal error. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-9817 

Write to audit file failed. 

Cause 

This is an internal error. 

Action 

Contact Oracle Worldwide Technical Support. 
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ORA-9818 

number is too large 

Cause 

Oracle was unable to convert a component string to a number because the 
number is larger than the largest possible value for an integer. The additional 
information field specifies the maximum. 

Action 

Correct the string and repeat the action. 

ORA-9819 

number exceeds maximum legal value 

Cause 

The number specified for a component was greater than the maximum value for 
that component. 

Action 

Change the component to a value less than the maximum and repeat the 
conversion. The maximum component number is contained in the "Additional 
Information" field. 

ORA-9820 

conversion of class string to numeric representation failed 

Cause 

Oracle was unable to convert a class string to a number because all of the 
characters in the string were not numeric. 

Action 

Change the string to be either all numbers or all non-numeric characters and 
repeat the conversion. 

ORA-9821 

parse of category string failed 

Cause 

Oracle expects a category string that is to be converted to be in the form 
"category 1, category2, categoryN." If the string is not in this format, this error is 
generated. 

Action 

Change the string to the correct format. 

ORA-9822 

Translation of audit file name failed. 

Cause 

Oracle was unable to translate the value of the audit_trail_dest initialization 
parameter. 

Action 

Check the UNIX number for a possible operating system error. If there is no 
error, contact Oracle Worldwide Technical Support. 

ORA-9823 

device name is too long 

Cause 

The name of a device was too long to fit into an internal buffer. The additional 
information field contains the length of the device name. 

Action 

This is an internal error. Contact Oracle Worldwide Technical Support. 
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ORA-9824 

Cause 

Action 


ORA-9825 

Cause 

Action 

ORA-9826 

Cause 

Action 

ORA-9827 

Cause 

Action 

ORA-9828 

Cause 

Action 

ORA-9829 

Cause 

Action 

ORA-9830 

Cause 

Action 

ORA-9831 

Cause 

Action 


Unable to enable allowmacaccess privilege. 

Oracle was not able to turn on allowmacaccess privilege so that it could do a 
label comparison. 

Check the UNIX number. If it indicates that Oracle does not have the 
allowmacaccess privilege, add the allowmacaccess privilege to the potential 
privilege set of $ORACLE_HOME/bin/oracle using chpriv (1M). If the 
executable already has the allowmacaccess privilege, contact Oracle Worldwide 
Technical Support. 

Unable to disable allowmacaccess privilege. 

Oracle was not able to turn off the allowmacaccess privilege after doing a label 
comparison. 

This is an internal error. Contact Oracle Worldwide Technical Support. 

SCLIN: cannot initialize atomic latch 

The system call atomic_opO returned an unexpected error. 

Check additional information in the trace file. 

SCLGT: atomic latch return unknown error 

The system call atomic_opO returned an unexpected error. 

Check additional information in the trace file. 

ACLFR: atomic latch return error 

The system call atomic_opO returned an unexpected error. 

Check additional information in the trace file. 
pw_createPorts: server call pws_start_instance failed 

The call pws_start_instance to (Oracle helper) failed, system resources might be 
exhausted. 

Make sure the server is still active. Check the error code returned in sercerrno, 
and look for error messages in the server log file. 

snyAddPort: failed to perform a remote procedure call 

The msg_rpc system call returned an error. 

Internal error. Contact Oracle Worldwide Technical Support. 

snyStartThread: failed to build the server port set 

The routine failed to build a port set on which to listen for request. 

Possible operating system failure. Contact Oracle Worldwide Technical Support. 
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ORA-9832 

infoCallback: bad message format 

Cause 

The routine received an incorrectly formatted request. 

Action 

Internal error. Contact Oracle Worldwide Technical Support. 

ORA-9833 

addCallback: bad message format 

Cause 

The routine received an incorrectly formatted request. 

Action 

Internal error. Contact Oracle Worldwide Technical Support. 

ORA-9834 

snyGetPort Set: failed to collect info on a port 

Cause 

The port_status system called failed. 

Action 

Possible operating system failure. Contact Oracle Worldwide Technical Support. 

ORA-9835 

addCallback: callback port is already in a set 

Cause 

The port to be added to the callback list is already in a port set. 

Action 

Internal error. Contact Oracle Worldwide Technical Support. 

ORA-9836 

addCallback: could not add a port to the callback set 

Cause 

The port_set_add system called failed. 

Action 

Possible operating system failure. Contact Oracle Worldwide Technical Support. 

ORA-9837 

addCallback: could not add allocate a callback link 

Cause 

The malloc library call failed to allocate space for a callback link. 

Action 

Possible operating system failure. Contact Oracle Worldwide Technical Support. 

ORA-9838 

removeCallback: failure removing the callback port 

Cause 

The port_set_remove system fall failed. 

Action 

Possible operating system failure. Contact Oracle Worldwide Technical 

Support. 

ORA-9839 

removeCallback: callback port is not in the callback set 

Cause 

The port to be removed to the callback list is not in the callback port set. 

Action 

Internal error. Contact Oracle Worldwide Technical Support. 

ORA-9840 

soacon: name translation failure 

Cause 

sltlnO could not translate the named pipe ?/dbs/mon2arch_@. 

Action 

Make sure that the ORACLE_HOME specified for this ORACLE_SID in oratab is 
correct. 
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ORA-9841 

Cause 

Action 

ORA-9842 

Cause 

Action 

ORA-9843 

Cause 

Action 

ORA-9844 

Cause 

Action 

ORA-9845 

Cause 

Action 

ORA-9846 

Cause 

Action 


soacon: name translation failure 

sltlnO could not translate the named pipe ?/dbs/arch2mon_@. 

Make sure that the ORACLE_HOME specified for this ORACLE_SID in oratab is 
correct. 

soacon: Archmon unable to create named pipe 

mknodO failed to create named pipe ?/dbs/mon2arch_®. 

Your current operating system login may lack write permission for the 
$ORACLE_HOME/dbs directory. Only user IDs in the dba group of a given 
instance can run archmon for that ORACLESID. Make sure that the 
ORACLE_HOME directory is correct in oratab. 

soacon: Archmon unable to create named pipe 

mknodO failed to create named pipe ?/dbs/mon2arch_®. 

Your current operating system login may lack write permission for the 
$ORACLE_HOME/dbs directory. Only user IDs in the dba group of a given 
instance can run archmon for that ORACLE_SID. Make sure that the 
ORACLE_HOME directory is correct in oratab. 

soacon: Archmon unable to open named pipe 

openO failed to open named pipe?/dbs/mon2arch_a. 

Only the Oracle DBA can run archmon. Make sure that your current operating 
system login has owner or group search permission for the $ORACLE_HOME 
/dbs directory. The maximum number of open files may have been exceeded. 

soacon: Archmon unable to open named pipe 

openO failed to open named pipe?/dbs/arch2mon_@. 

Only the Oracle DBA can run archmon. Make sure that your current operating 
system login has owner or group search permission for the 
$ORACLE_HOME/dbs directory. The maximum number of open files may 
have been exceeded. 

soacon: ARCH unable to open named pipe 
openO failed to open named pipe ?/dbs/mon2arch_@. 

Make sure that the operating system user ID of the database has search 
permission for the $ORACLE_HOME/dbs directory. The maximum number of 
open files may have been exceeded. 
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ORA-9847 

soacon: ARCH unable to open named pipe 

Cause 

openO failed to open named pipe ?/dbs/arch3mon_@. 

Action 

Make sure that the operating system user ID of the currently running database 
has search permission for the $ORACLE_HOME/dbs directory. The maximum 
number of open files may have been exceeded. 

ORA-9848 

soawrt: Unable to write to named pipe 

Cause 

Failed to write to named pipe. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-9849 

soarcv: Unable to read from named pipe 

Cause 

Failed to read from named pipe. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-9850 

soacon: Archmon unable to lock named pipe 

Cause 

fcntlO failed to set write lock on named pipe ?/dbs/arch2mon_@. 

Action 

Make sure that archmon is not already active on another terminal for this 
ORACLE_SID. Only one archmon session is allowed at a time for a given 
instance. 

ORA-9851 

soacon: Archmon unable to lock named pipe 

Cause 

fcntlO failed to set read lock on named pipe ?/dbs/mon2arch_@. 

Action 

Make sure that archmon is not already active on another terminal for this 
ORACLE_SID. Only one archmon session is allowed at at time for a given 
instance. 

ORA-9852 

sfgced: failed to get the name of the current directory 

Cause 

The request to get the name of the current directory failed. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-9853 

snyRemovePort: bad return code from request 

Cause 

The request to remove a port from the callback set returned a failure code. 

Action 

Possible operating system error. Contact Oracle Worldwide Technical Support. 

ORA-9854 

snyPortlnfo: bad return from request 

Cause 

The request to collect information on a port in the callback set returned a failure 
code. 

Action 

Possible operating system error. Contact Oracle Worldwide Technical Support. 
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ORA-9855 

Cause 

Action 

ORA-9856 

Cause 

Action 

ORA-9857 

Cause 

Action 

ORA-9870 

Cause 

Action 

ORA-9871 

Cause 

Action 

ORA-9872 

Cause 

Action 

ORA-9873 

Cause 

Action 

ORA-9874 

Cause 

Action 

ORA-9875 

Cause 

Action 


removeCallback: bad message format 

The routine received an incorrectly formatted request. 

Internal error. Contact Oracle Worldwide Technical Support, 
smpalo: vm_protect error while protecting pga 
The vm_allocate system call returned an error. 

Check returned error. Possibly out of system resources, 
smprset: vm_protect system call returned an error. 

The vm_protect system call returned an error. 

Internal error. Contact Oracle Worldwide Technical Support, 
spini: failure initializing maximum number of open files 
The ulimit system call returned an error. 

Check UNIX error number. 

TASDEF_NAME: translation error while expanding ?/dbs/tasdef@.dbf 
Failure of sltln (?/tasdef@.dbf) while creating test and set pages. 

Check additional return error for more information. 

TASDEF_CREATE: create failure in creating ?/dbs/tasdef@.dbf 
CreateO failed when trying to create the tasdef file 
Verify permissions on $ORACLE_HOME/dbs directory. 

TASDEF_OPEN: open error when opening tasdef@.dbf file 
Unable to open tasdef®.dbf file. 

Check error number. Possible permission problem. Verify that tasdef@.dbf file 
exists. 

TASDEF_READ: error, unable to read tasdef@.dbf file 

Read system call returned an error when attempting to read ?/dbs/tasdef@.dbf. 

Check error number returned. Sgadef file may be corrupted or incompatible 
with Oracle version. 

TASDEF_WRITE: write error when writing ?/dbs/tasdef@.dbf file 

Write call failed. 

Check error number returned. Possibly out of space on device. 
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ORA-9876 

TASDEF_CLOSE: unable to close ?/dbs/tasdef@.dbf file 

Cause 

Close system call returned an error. 

Action 

Check error number returned. Possible operating system failure. 

ORA-9877 

sstascre: shmget error, unable to get a shared memory segment 

Cause 

Error in shmget. 

Action 

Check error number returned. Verify that enough shared memory is available 
on the system. 

ORA-9878 

sstascre/sstasat: shmat error, unable to attach tas write page 

Cause 

Error in shmat. 

Action 

Check error number returned. Verify that enough shared memory is available 
on the system. 

ORA-9879 

sstascre/sstasat: shmat error, unable to attach tas read page 

Cause 

Error in shmat. 

Action 

Check error number returned. Verify that enough shared memory is available 
on the system. 

ORA-9880 

sstasfre/sstasdel: shmdt error, unable to detach tas write page 

Cause 

Error in shmat. 

Action 

Check error number returned. 

ORA-9881 

sstasfre/sstasdel: shmdt error, unable to detach tas read page 

Cause 

Error in shmat. 

Action 

Check error number returned. 

ORA-9882 

sstasfre/sstasdel: shmctl error, unable to remove tas shm page 

Cause 

Error in shmctl. 

Action 

Check error number returned. 

ORA-9883 

Two Task interface: /etc/oratab/does not exist 

Cause 

The /etc/oratab file does not exist. 

Action 

Install Oracle before you use it or recreate the /etc/oratab file. 

ORA-9884 

Two Task interface: SID does not match current PU 

Cause 

You are trying to start Oracle on another PU than you configured Oracle on, or 
there is no entry for this SID in /etc/oratab. 

Action 

Start Oracle with this SID on its designated PU (see /etc/oratab). 
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ORA-9885 

Cause 

Action 

ORA-9886 

Cause 

Action 

ORA-9887 

Cause 

Action 

ORA-9888 

Cause 

Action 


ORA-9889 

Cause 

Action 

ORA-9890 

Cause 

Action 

ORA-9894 

Cause 

Action 

ORA-9895 

Cause 

Action 


osnTXtt: cannot create txipc channel 

The txipc driver failed to create pipes for two-task communications with the 
Oracle shadow process. 

You have probably exceeded the maximum number of open file descriptors per 
user or the system file table is full. Note the operating system error code and 
contact your system administrator. 

osnTXtt: translation error while expanding txipc@.trc 

Failure of sltln (txipc@.trc) while creating debug channel. 

Check additional return error for more information. 
osnTXtt: Failed to create/open debug channel 
Unable to create or open debug channel. 

Contact Oracle Worldwide Technical Support. 
osnTXtt: txipc channel creation failed 

The txipc driver failed to create channels for two-task communications with the 
oracle shadow process. 

You have probably exceeded the maximum number of open file descriptors per 
user or the system file table operating system error code and contact your 
system administrator. 

osnTXtt: access error on oracle executable 

The txipc driver could not access the Oracle executable. 

Check the permissions on the Oracle executable and each component of the 

$ORACLE_HOME/bin path. 

osnTXtt: malloc failed 

The txipx driver failed to allocate enough heap space for its context area buffers. 
Contact Oracle Worldwide Technical Support. 

sfwrt: Unbale to initialize Async Write 
DIO_Ainit returned an error. 

Possible operating system memory resource shortage. 

sfaswr: seals do not match 

Function was called with invalid argument. 

Contact Oracle Worldwide Technical Support. 
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ORA-9896 

sfaswr: invalid block number 

Cause 

File block number is out of range of file. Additional information returns block 
number. 

Action 

Check block number. 

ORA-9897 

sfaswr: write error, unable to write database block 

Cause 

Additional information returns block number. 

Action 

Check error number. Check block number. Possible problem with Async I/O. 

ORA-9898 

sfalck: settimer error, unable to set interval timer 

Cause 

DIO_Apoll timed out. 

Action 

Check error number. 

ORA-9899 

sfapol: write error, unable to poll async write 

Cause 

DIO_Apoll timed out. 

Action 

Check I/O device, or turn off async_write. 

ORA-9900 

sfapol: write error, unable to poll async_write 

Cause 

DIO_Apoll returned an error. Possible internal error. 

Action 

Check I/O device, or turn off async_write. Check error number. 

ORA-9901 

sfapol: write error, unable to write database block 

Cause 

Additional information returns block number. 

Action 

Check error number. Check block number. 

ORA-9902 

sfapol: write returned incorrect number of bytes 

Cause 

Possible truncated write. Additional information returns block number and 
number of bytes. 

Action 

Check block number and number of bytes written. 

ORA-9903 

sfwrt: Internal error 

Cause 

Failed to write all requested blocks. 

Action 

Check block number and number of bytes written. 

ORA-9904 

sfoft: temporary file directory name is too long 

Cause 

The name of the directory where temporary sort files are to reside is longer than 
the maximum 120 characters. 

Action 

Set the init.ora parameter temporary_sort_file_dest to less than the maximum 
length. 


7-116 Oracle7 for UNIX 










ORA-9905 

sfotf: mktempO failed 

Cause 

The routine used to generate the names of the temporary sort files failed. No 
more names were available. 

Action 

This is an internal error. Contact Oracle Worldwide Technical Support. 

ORA-9906 

sfotf: open of the temporary sort file failed. 

Cause 

A file that is to be used as temporary sorting file could not be opened. 

Action 

Check the errno. The init.ora parameter temporary_sort_file_dest may not point 
to a directory. 

ORA-9907 

sfotf: unlink of the temporary sort file failed 

Cause 

As part of the process of creating a temporary sort file, the file is removed while 
the process has it open. The file still exists because the process has not closed it. 

However, the unlink failed. 

Action 

This is an internal error and should never happen. 

ORA-9908 

slkmnm: gethostname returned error code. 

Cause 

The system call gethostname returned an error. 

Action 

This is most likely an internal error. Make sure gethostname is successful in 
other contexts, and if so contact Oracle Worldwide Technical Support. 

ORA-9909 

Malloc of scratch buffer failed. 

Cause 

Memory needed for a temporary buffer could not be allocated. The additional 
information field contains the number of bytes that Oracle attempted to allocate. 

Action 

Check the UNIX number. It is probable that the system has run out of memory. 

If there is no error, contact Oracle Worldwide Technical Support. 

ORA-9910 

Unable to find Oracle password file entry for user. 

Cause 

No entry exists for the user in the Oracle password file. 

Action 

Have the database administrator install a password entry by running orapwd. 

ORA-9911 

Incorrect user password. 

Cause 

The password entered by the user was incorrect. 

Action 

Enter the correct password. 

ORA-9912 

Malloc of name buffer(s) failed. 

Cause 

Oracle was unable to allocate memory for one or both of the buffers that are 
used to hold the name of DBA and the operator users. 

Action 

Check the UNIX number. It is probable that the system has run out of memory. 

If there is no error, contact Oracle Worldwide Technical Support. 
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ORA-9913 

Malloc of dummy name failed. 

Cause 

Oracle was unable to allocate memory for the user name that is to be used in the 
encryption of the user's password. 

Action 

Check the UNIX error number. It is probable that the system has run out of 
memory. If there is no error, contact Oracle Worldwide Technical Support. 

ORA-9914 

Unable to open the ORACLE password file. 

Cause 

Oracle could not open the password file for reading. 

Action 

Check the UNIX number. If the number indicates that the file does not exist, 
have the database administrator create the file by running orapwd. If the 
number indicates insufficient permissions, ask the database administrator to 
change the permissions. Otherwise, contact Oracle Worldwide Technical 
Support. 

ORA-9915 

Password encryption failed. 

Cause 

Oracle was unable to encrypt a password. 

Action 

This is an internal error. Contact Oracle Worldwide Technical Support. 

ORA-9916 

Required password was not specified 

Cause 

A user attempted to CONNECT INTERNAL, but did not specify a password. 

Action 

Connect as internal again, while specifying a password. 

ORA-9917 

DBA group does not exist in system groups file 

Cause 

The group that was selected to hold the names of the dba users does not exist in 
/etc/groups. 

Action 

Add an entry for the group to the file or re-install Oracle with the proper group 
name. 

ORA-9918 

Unable to get user privileges from SQL*Net 

Cause 

Oracle was unable to retrieve the user's privilege set from the SQL*Net 
connection. 

Action 

Check the UNIX number for a possible operating system error. Also check the 
"additional information" field for the SQL*Net error. If there is no error, contact 
Oracle Worldwide Technical Support. 

ORA-9919 

Unable to set label of dedicated server 

Cause 

Oracle was unable to set the label of the dedicated to server to the required 
value. 

Action 

Check the UNIX number for a possible operating system error. Also, check the 
privileges on the oracle executable. It should have at least allowmacaccess 
privilege. 
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ORA-9920 

Cause 

Action 

ORA-9921 

Cause 

Action 

ORA-9922 

Cause 

Action 


ORA-9923 

Cause 

Action 


Unable to get sensitivity label from connection 

Oracle was unable to retrieve the user's sensitivity label from the SQL*Net 
connection. 

Check the UNIX number for a possible operating system error. Also check the 
"additional information" field for the SQL*Net error. If there is no error, contact 
Oracle Worldwide Technical Support. 

Unable to get information label from connection 

Oracle was unable to retrieve the user's information label from the SQL*Net 
connection. 

Check the UNIX number for a possible operating system error. Also check the 
"additional information" field for the SQL*Net error. If there is no error, contact 
Oracle Worldwide Technical Support. 

Can't spawn process - background log directory not created properly 

Oracle was unable to spawn a background process because the directory that 
will hold trace files of the background processes was not created properly. 

Examine the directory pointed to by the initialization parameter 
background_dump_dest. Make sure that all of the following is true: 

1. The directory exists. 

2. The name indeed points to a directory, and is 
not a file. 

3. The directory is accessible and writeable to the 
oracle software owner. 

Can't spawn process - user log directory not created properly 

Oracle was unable to spawn a background process because the directory that 
holds the trace files of the dedicated server processes was not created properly. 

Examine the directory pointed to by the initialization parameter 
user_dump_dest. Make sure that all of the following is true: 

1. The directory exists. 

2. The name indeed points to a directory, and is 
not a file. 

3. The directory is accessible and writeable to the 
oracle software owner. 


UNIX Messages and Codes 7-119 







ORA-9924 

Can't spawn process - core dump directory not created properly 

Cause 

Oracle was unable to spawn a background process because the directory that 
holds the core dumps produced by Oracle processes in the event of exceptions 
was not created properly. 

Action 

Examine the directory pointed to by the initialization parameter 
core_dump_dest. Make sure that all of the following is true: 

1. The directory exists. 

2. The name indeed points to a directory, and 
is not a file. 

3. The directory is accessible and writeable to 
the oracle user. 

ORA-9925 

Unable to create audit trail file 

Cause 

Oracle was not able to create the file being used to hold audit trail records. 

Action 

Check the UNIX number for a possible operating system error. If there is no 
error, contact Oracle Worldwide Technical Support. 

ORA-9926 

Unable to set effective privilege set of the server 

Cause 

A dedicated server was unable to set its own privilege set. 

Action 

Check the privileges granted to the Oracle executable. It must have at least 
allowmacacess privilege. 

ORA-9927 

Unable to set label of server 

Cause 

Oracle was not able to set the label of a server to a new value. 

Action 

Check the privileges on $ORACLE_HOME/bin/oracle. Make sure that it has 
allowmacaccess privilege. 

ORA-9928 

Unable to restore the label of server 

Cause 

Oracle was unable to restore the label of the server to the value that it had before 
raising it to database high. 

Action 

This is an internal error. Contact Oracle Worldwide Technical Support. 

ORA-9929 

GLB of two labels is invalid 

Cause 

The result of a greatest lower bound operation on two labels was not valid. 

Action 

Repeat the operation with two different labels. Consult the system encoding file 
for the values of valid labels. 
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ORA-9930: 

LUB of two labels is invalid 

Cause 

The result of a least upper bound operation on two labels was not valid. 

Action 

Repeat the operation with two different labels. Consult the system encoding file 
for the values of valid labels. 

ORA-9931 

Unable to open oracle password file for reading 

Cause 

An attempt to open a password file for reading failed. 

Action 

Make sure that the permissions on the file have not been changed so that the 
Oracle software owner cannot open it. 

ORA-9932 

Close of ORACLE password file failed. 

Cause 

An attempt to close a password file failed. 

Action 

Check the UNIX number for the specific reason. 

ORA-9933 

Deletion of old password file failed. 

Cause 

The removal of the old password file failed. 

Action 

Check the UNIX number for the specific reason. 

ORA-9934 

Link of current password file to old failed. 

Cause 

Oracle was unable to create a link so that the old password file could be saved. 

Action 

Check the UNIX number for the specific reason. 

ORA-9935 

Unlink of current password file failed. 

Cause 

Oracle was unable to complete the saving of the current password file. 

Action 

Check the UNIX number for the specific reason. 

ORA-9936 

Open of ORACLE password file for write failed. 

Cause 

Oracle was unable to create a password file. 

Action 

Check the UNIX number for the specific reason. 

ORA-9937 

Chmod of ORACLE password file failed. 

Cause 

Oracle was unable to change a password file to be readonly. 

Action 

Check the UNIX number for the specific reason. 

ORA-9938 

Save of signal handlers failed. 

Cause 

Oracle was unable to save the previous values of selected signal handlers. 

Action 

This is an internal error. Contact Oracle Worldwide Technical Support. 
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ORA-9939 

Restoration of signal handlers failed. 

Cause 

Oracle was unable to restore the previous values of selected signal handlers. 

Action 

This is an internal error. Contact Oracle Worldwide Technical Support. 

ORA-9940 

Oracle password file header is corrupt 

Cause 

The header of one of the password files was not in the format that Oracle 
expected. 

Action 

Check the headers of both files. The header should be in the format FILE 
VERSION: N.N.N.N.N EXECUTABLE VERSION: N.N.N.N.N where N is a 
number. Remove the corrupt file(s) and re-run orapwd. 

ORA-9941 

Version of orapwd or Installer is older than file. 

Cause 

The version of orapwd or Installer being run is older than that of the Oracle 
password file. Since the file version is only changed when the format is 
changed, this error means that the executable is using a different format than 
that with which the file was created. 

Action 

Run a version of the Installer or orapwd whose version is the same or later than 
that of the file. 

ORA-9942 

Write of Oracle password file header failed. 

Cause 

The attempt to write out the header of the Oracle password file failed. 

Action 

Check the operating system number. It is possible that the file system became 
full. 

ORA-9943 

Allocation of memory for password list component failed. 

Cause 

When it is building a list of password file entries, Oracle allocates memory for 
various components. One of the allocations failed. 

Action 

Check the operating system number. The system has probably run out of 
memory. 

ORA-9944 

Password entry is corrupt. 

Cause 

An entry in an Oracle password file was not in the format that Oracle expected. 

Action 

Remove the corrupt file(s) and re-run orapwd. 

ORA-9945 

Unable to initialize the audit trail file 

Cause 

Oracle unable to write header information to the file being used as the audit 
trail. 

Action 

Check the UNIX number for a possible operating system error. If there is no 
error, contact Oracle Worldwide Technical Support. 
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ORA-9946 

Cause 

Action 

ORA-9947 

Cause 


Action 

ORA-9948 


File name too long for buffer 

The buffer that was to be used to hold a file name was determined to be too 
short for the generated name. This will happen if the translated name for either 
a trace file or an audit file is longer than the maximum allowed, which on many 
ports is 256 characters. 

Use a shorter file name. 

Unable to allocate connection attributes structure 

Oracle was not able to allocate the memory needed to hold the attributes of the 
SQL*Net connection. The "Additional Information" field holds the number of 
bytes Oracle attempted to allocate. 

Check the UNIX number. It is probable the system has run out of memory. If 
there is no error, contact Oracle Worldwide Technical Support. 

Process information label retrieval failed. 


Cause 

Action 

ORA-9949 

Cause 

Action 

ORA-9950 

Cause 

Action 

ORA-9951 

Cause 

Action 

ORA-9952 

Cause 

Action 


Oracle was unable to get the information label for a process. 

Check the UNIX number. If there is no error, contact Oracle Worldwide Technical 
Support. 

Unable to get client operating system privileges 

Oracle was unable to get the operating system privileges for the client process. 

Check the UNIX number for a possible operating system failure. If there is no 
error, contact Oracle Worldwide Technical Support. 

Unable to get server operating system privileges 

Oracle was unable to get its privileges from the operating system. 

Contact Oracle Worldwide Technical Support. 

Unable to create file 

Oracle was unable to create a file. 

Check the UNIX number for a possible operating system failure. If there is no 
error, contact Oracle Worldwide Technical Support. 

scgcmn: lk_open_convert unexpected return: open failed 

The distributed lock manager returned an unexpected value. 

Check for a system message and refer to the distributed lock manager 
documentation. Alternatively, contact Oracle Worldwide Technical Support. 
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ORA-9953 

scggc: unexpected return of a lock convert 

Cause 

The distributed lock manager returned an unexpected value. 

Action 

Check for a lock manager message and refer to the distributed lock manager 
documentation. Alternatively, contact Oracle Worldwide Technical Support. 

ORA-9954 

scgcc: unexpected return status to callback of lock close 

Cause 

The distributed lock manager returned an unexpected value. 

Action 

Check for a lock manager message and refer to the distributed lock manager 
documentation. Alternatively, contact Oracle Worldwide Technical Support. 

ORA-9955 

scgcan:unexpected return status when canceling a lock 

Cause 

The lock manager system service x returned an unexpected value. 

Action 

Check for system message and refer to the distributed lock manager 
documentation. Alternatively, contact Oracle Worldwide Technical Support. 

Cause 

The global locking system service returned an unexpected value. 

Action 

Check for a system message (if any) and refer to the distributed lock manager 
documentation. Alternatively, contact Oracle Worldwide Technical Support. 

ORA-9957 

Unable to send termination request to IMON 

Cause 

The attempt to send a termination signal to IMON failed. 

Action 

Contact Oracle Worldwide Technical Support. 

ORA-9958 

IMON: two processes with the same ORACLE pid are active 

Cause 

The IMON process was unable to add an entry for a server process because 
another active process occupies the slot. 

Action 

This is an internal error. Contact Oracle Worldwide Technical Support. 

ORA-9959 

IMON: deletion of a process failed. 

Cause 

The IMON process was unable to delete a server process from its process ID 
array because no entry for the process could be found. 

Action 

This is an internal error. Contact Oracle Worldwide Technical Support. 

ORA-9960 

Unable to establish signal handler for termination signal 

Cause 

Oracle was unable to set up a handler for the signal used to notify it that the 
instance was shutting down. 

Action 

This is an internal error. Contact Oracle Worldwide Technical Support. 
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ORA-9961 

Cause 

Action 


Unable to restore termination signal handler 

Oracle failed to set the handler for the termination signal to its previous value. 

This is an internal error. Contact Oracle Worldwide Technical Support. Check to 
see that the alias exists in one of the tnsnames.ora files and add it if it is not 
there. Check to see that the database name exists in one of the tnsnames.ora 
files and add it if necessary. See the ICG for more details. 
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SQL*Net TNS Driver Messages 

ORA-12221 TNS:illegal ADDRESS parameters 


Cause 

An illegal set of protocol adapter parameters was specified. In some cases, this 
error is returned when a connection cannot be made to the protocol transport. 

Action 

Verify that the destination can be reached using the specified protocol. Check 
the parameters within the ADDRESS section of TNSNAMES.ORA. Legal 
ADDRESS parameter formats may be found in the Oracle operating system 
specific documentation for your platform. Protocols that resolve names at the 
transport layer (such as DECnet object names) are vulnerable to this error if not 
properly configured or names are misspelled. 

ORA-12222 

TNS:no such protocol adapter 

Cause 

The protocol adapter requested (by way of the (PROTOCOL=..) keyword-value 
pair in a TNS address) is unknown. If the supplied address is typographically 
correct then the protocol adaptor is not installed. 

Action 

Install the protocol adapter or correct the typographical error, as appropriate. 
Note that if the supplied address was derived from resolving the service name, 
check the address in the appropriate file (TNSNAMES.ORA, LISTENER.ORA, 
or TNSNET.ORA). 

ORA-12223 

TNSiinternal limit restriction exceeded 

Cause 

Too many TNS connections open simultaneously. 

Action 

Wait for connections to close and retry. 

ORA-12224 

TNS:no listener 

Cause 

The connection request could not be completed because the listener is not 
running. 

Action 

Ensure that the supplied destination address matches one of the addresses used 
by the listener; compare the TNSNAMES.ORA entry with the appropriate 
LISTENER.ORA file (or TNSNAV.ORA if the connection is to go by way of an 
Interchange). Start the listener on the remote machine. 

ORA-12225 

TNSidestination host unreachable 

Cause 

Contact cannot be made with remote party. 

Action 

Make sure the network driver is functioning and the network is up. 

ORA-12226 

TNSioperating system resource quota exceeded 

Cause 

The current user has exceeded the allotted resource assigned in the operating 
system. 

Action 

Acquire more operating system resource, or perform a different function. 
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ORA-12227 

TNS:syntax error 

Cause 

The supplied connect descriptor contains illegal syntax. 

Action 

Check the syntax of the connect descriptor in TNSNAMES.ORA. 

ORA-12228 

TNS:protocol adapter not loadable 

Cause 

On some platforms (such as OS/2) protocol adapters are loaded at run time. If 
the shared library (or DLL) for the protocol adapter is missing or one of its 
supporting libraries is missing, this error is returned. 

Action 

For further details, turn on tracing and re-execute the operation. The trace file 
will include the name of the shared library (or DLL) that could not be loaded. 

ORA-12229 

TNS:Interchange has no more free connections 

Cause 

One or more interchanges along the path to the destination desired has no more 
free connections available to be used for this call. 

Action 

Try again later when the interchanges are less busy, or contact your network 
administrator to have him determine which interchange it is, and increase the 
number of connections available on that interchange. 

ORA-12230 

TNS:Server Network error occurred in making this connection 

Cause 

This error is reported by an interchange which fails to make contact with the 
destination due to a physical network error while calling a destination. 

Action 

Try again later when the network service may have been fixed or report the 
problem to your network administrator so that he may fix the problem. 

ORA-12501 

TNS:Listener failed to spawn process. 

Cause 

The listener failed to start the program specified. 

Action 

This is not seen in normal use of SQL*Net. Check the alias of the program 
started by listener in the system listener.ora file. Make sure the program exists 
and the arguments are correct. 

ORA-12503 

TNS:Syntax error in the address resolved from the database name 

Cause 

The CONNECTDATA passed to listener has a syntax error. 

Action 

Check that the database name resolved from tnsnames.ora has matching 
parentheses and the CONNECT DATA in the connect descriptor has an sid 
component specifying the database to be used on the listener machine. See the 

SQL*Net V2 Administrator's Guide for more information on connect descriptors. 

ORA-12506 

TNS:Listener was not given the ALIAS in CONNECTEDATA. 

Cause 

The SID was missing from the CONNECT DATA. 

Action 

This is not seen in normal use of SQL*Net. Check the command line or 
name-address mappings for the ALIAS component of the CONNECT_DATA. 
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ORA-12507 

Cause 

Action 

ORA-12598 

Cause 

Action 

ORA-12599 

Cause 

Action 


TNS: Listener could not resolve ALIAS given. 

The ALIAS in CONNECT DATA was not found in the system tnsnames.ora file. 

This is not seen in normal use of SQL*Net. Check to make sure that the ALIAS 
specified is correct. 

TNS: operation failed due to error returned by native service 

The TNS native service component returned an error. 

Details of the exact violation are reported in the "secondary error" field of the 
TNS result descriptor. If necessary, turn on tracing and re-execute the operation 
to see the result descriptor. 

TNS:cryptographic checksum mismatch 

The data received is not the same as the data sent. 

Attempt the transaction again. If error persists, check (and correct) the integrity 
of your physical connection. 
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Problems 


r f his appendix answers the questions most frequently asked by 
Oracle customers. 
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Common Questions and Answers 


This question and answer section was compiled by an Oracle Support 
Engineer, and represents a general consensus of questions frequently 
asked by customers. Not all questions apply to all UNIX platforms. 
Exceptions have been noted. 

Where possible, we have included references to specific chapters of the 
ICG for a more extensive discussion of the topic. 


Pre-installation 

Overview 

1. What are some good resources to help me prepare for installing the 
Oracle Server? 

In addition to this book, which provides information for Oracle on 
UNIX, the Oracle for UNIX Installation and Configuration Guide (ICG) 
and the Oracle for UNIX Tools Administrator's Reference Guide ( TARG) 
should be used as your primary sources of information. 

2. Can you give a brief overview of how the installation process 
works? 

You install Oracle products using the Installer, an interactive 
menu-based program. Use the Installer to: 

• check product dependencies and disk space 

• install Oracle products quickly and conveniently 

• answer all questions about installing before the actual installation 
takes place 

• update existing Oracle products to the latest version 

• remove existing Oracle products 

• list available and installed Oracle products 

• access the comprehensive online help facility 

The ICG for your platform documents use of the Installer, as well as 
pre- and post-installation activities. 

Requirements 

3. How do I find out how much space I will need for each product? 

The "Key to Oracle on UNIX" chapter of the ICG gives you exact 
numbers for how much space is needed for each product. We come 
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up with these numbers by doing a Is -1 for each product. This 
command returns the directory size in operating system blocks. 
Operating system blocks are typically either 512 bytes for System V 
machines or IK on BSD machines. 

4. Where do 1 find information about memory requirements for the 
Oracle Server? How are these requirements calculated? 

Information about memory requirements is presented in the "Key to 
Oracle on UNIX" chapter of the ICG. 

Roughly speaking, every UNIX process is divided into text, data, 
and stack sections. When the first user uses an executable, all three 
sections are needed. If a second user uses the same executable, they 
use the same text segment as the first user, but need their own data 
and stack sections. So only the data and stack sections need to be 
added for each additional user. The UNIX command size is 
extremely helpful in determining these values. 

5. The version of the operating system that I have and the one 
mentioned in the ICG do not match. Is this OK? 

No. Call Oracle Customer Support and ask them if the version of the 
Oracle Server that you have is certified to run on that operating 
system release. If your operating system version is older than the 
one stated in the "Key to Oracle on UNIX" chapter of the ICG , 
chances are that it is not supported. In either case, please call 
Support to be sure. 

Limitations 

6. Is there a limitation on the number of characters that can be used for 
the ORACLE_SID? 

Some operating systems impose a limitation on the number of 
characters that you can use because of the maximum length of 
filenames. For example, the System V filesystem will only accept a 
sid with a maximum of 4 characters because of the 14-character 
filename limitation. 

root.sh Installation Scripts 

7. What does root.sh actually do? 

For various products, primarily networking products, the root.sh 
script carries out installation procedures which must be performed 
by the root user. 

8. Is root.sh absolutely necessary? 
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The root.sh script sets up file ownerships, modifies your .profile or 
.login file, and puts an entry into /etc/oratab. A lot of this can be 
done manually, but if the files are already owned by oracle , this can 
be avoided. You can always create an/etc/oratab file. However, we 
strongly recommend running root.sh so that everything is set up 
correctly. 

9. Once I have run root.sh, do I have to run it again? 

Not if root.sh ran successfully. Check your installation log file to see 
whether errors occurred during the installation process. 

You do have to run this script again if you later decide to install new 
networking products which require root.sh. 

Installation 

Product installation 

10. How does the install script know the order in which the products 
are installed? 

In unix.prd, the first column is a numeric key indicating the install 
order. The unix.prd file is constructed from 

producf/install/partial.prd, if you are installing from tape. Note that 
the CD ROM distribution does not have partial.prd files. 

For example, $ORACLE_HOME/sqlplus/install/partial.prd 

contains the following information: 

1000 plus "SQL*Plus" "sqlplus/install" 

The first field number, 1000 in this case, gives the relative position of 
SQL*Plus in the installation process. Any products with a value less 
than 1000 in their partial.prd file are installed before SQL*Plus and 
those above 1000 are installed after SQL*Plus. 

The above lines are collected from each partial.prd file and put 
together into a file called unix.prd, located in 
$ORACLE_HOME/install. Here, they are sorted by number. There 
are large gaps in the numbering which allows for new products to 
be added in the future. 

11. There are cases where certain products have to be installed before 
others. For example, Oracle*Toolkit needs to be installed before 
SQL*Forms. How do the install scripts take care of these 
dependencies? 

Product dependencies are built into the scripts. 
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12. Do I have to install all the products in the beginning, or can I install 
some products later? 

You can load and install the products whenever you want. The only 
exception is the Oracle Server, which must be installed first. 

13. If the installation for a certain product did not succeed, do I have to 
re-install the entire database? 

No, just select the product that failed. If the installation failed the 
first time, check the install log file to determine the cause of the 
error. 

14. If I get a new product on a separate tape in the future, can I just 
install it on its own? 

Absolutely not. Mixing different products from different releases in 
the same ORACLE_HOME is not supported. If you are upgrading a 
single product to a later version, you must also upgrade all the 
software in that ORACLE HOME. It is possible for clients and 
servers connected through SQL*Net to have different versions of 
Oracle products. 

15. If I don't need a certain product, can I delete the files in that 
directory? 

Use the Installer to deinstall the product. 


Installation prompts 

16. Does ORACLE_HOME have to correspond to HOME? 

No. The HOME environment variable is the home directory for 
your account. ORACLE_HOME can be any directory. 

17. What is the bin directory that is mentioned in the root.sh? Is it the 
same as $ORACLE_HOME/bin? 

The bin directory referred to by the root.sh script is different from 
$ORACLE_HOME/bin. The root.sh script copies five executables, 
for future use, into a directory that you specify (for example 
/usr/local/bin). The easiest thing to do here is to create an empty 
directory and use its full path name when prompted to give a local 
bin directory. 

See the "Key to Oracle on UNIX" chapter of the ICG to find out the 
default local bin directory pathname for your system. 


Relinking 


18. What does the message "Do you want to relink?" actually mean? 
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If you answer yes to the above question, each product remakes its 
corresponding executable (using make) and then copies it back to 
$ORACLE_HOME/bin. (Currently, only products selected in the 
Available Products Window are relinked.) As a result of this 
process, you effectively have a new set of executables. If, on the 
other hand, you answer no to the above question, the installation 
goes faster since no executables are remade. 

Note that the installation of some products forces a relink, even if 
you answer no to the above question. 

19. Which are some of the products that force a relink? 

PL/SQL relinks no matter what answer you give to the relinking 
question. SQL*Net VI and V2 will relink with the Oracle Server 
kernel (server code). You must answer yes to relink the Oracle tools 
for SQL*Net. 

20. Why do the above products relink anyway? 

Since the above-mentioned products become part of the kernel, the 
oracle executable needs to be regenerated. In addition, these 
products are licensed separately from the kernel, and are treated as 
such. 

Post-Installation 

Automatic startup 

21. In the post installation procedure for most platforms, it is 
recommended that you enter the following command in the /etc/rc 
file for automatic database startup. 

# su - oracle -c '/usr/oracle/bin/dbstart' 

What does this mean? 

This command is executed as root when the system reboots. 

su change user to oracle (no password is 

needed from root) 

- inherit the environment of the oracle 

account, which initializes your 
ORACLE_HOME and sid among other 
things 

oracle the oracle account 

-c execute the next command given 
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dbstart 


script that starts up all databases that have 
a Y in the third field of /etc/oratab 

Note: The name of the startup file is operating-system specific. 

There is also a script called dbshut which can be placed in the 
system shutdown file that would shutdown all databases when the 
operating system is shut down. 

For more information on dbstart and dbshut, see the Automatic 
Database Startup and Shutdown" section in the "Completing the 
Installation" chapter of the ICG. 


Default configuration 

22. If I accept the defaults, what kind of database do I have? 

The default database has the following characteristics: 

• the system tablespace is as small as possible 

• product database tables are in the tools tablespace 

. the rollback segment tablespace contains all rollback segments 
except the system rollback segment 

• a temp tablespace exists; any users created should be set up to 
use this as their temporary tablespace 

. the users tablespace should be the default tablespace for any new 
users created. 

. control files and database files are all on the same disk. This is not 
the recommended situation: you should move all these files to 
separate disks, if possible. 

23. Do I have to bring up the database manually after the installation? 
No, the Installer does that automatically. 

24. How does the Oracle Server check to see if a database is running? 

When the database is started up, a file called sgadefs/d.dbf is 
created in $ORACLE_HOME/dbs. The existence of this file 
indicates that the database is up. However, sometimes during an 
abnormal situation, a database may be shut down without cleaning 
up that file first. If this happens, you can try removing that file and 
then restarting the database. 

Alternatively, you can use the ps command and check for the 
existence of background processes. 

25. If I want to create my own database manually, can I do it without 
running the Installer? 
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Groups 


Yes. Here are the steps to create a new database with TEST as the 
sid, in a non-OFA installation. 

Change your sid to TEST, and proceed with the following 
commands: 


$ cd $ORACLE_HOME/dbs 

$ cp init.ora initTEST.ora 

$ SQLDBA lmode=y 

SQLDBA> connect internal 

SQLDBA> startup nomount 

SQLDBA> create database 

SQLDBA> @?/rdbms/admin/catalog.sql 



Additional Information: When creating the database, refer to 
the Oracle Server Administrator's Guide for the appropriate 
options. 


26. How do I check how my account is defined and what my default 
group is? 

The /etc/passwd file defines all accounts. A typical entry might be: 

oracle:hnaBn809usjYs:8000:100:John Doe:/usr/oracle:/bin/sh 


oracle 

hnaBn809usjYs 

8000 

100 

John Doe 

/usr/oracle 

/bin/sh 


the account name 
the password in encrypted form 
the account id 
the group id 

the owner of the account 

the home directory of the account 

the default shell 


This may vary on some systems. 
An entry in /etc/group might be: 

dba:*:8000:oracle,jdoe 


dba 


8000 

oracle, jdoe 


the group name 

the encrypted group password (never really 
used) 

the group id 

the members of the group 
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27. I have already set up a group called "dba", do I also need to set up 
a group called "oracle?" 

No. The reason is that in UNIX there are three levels of security: 
user, group and world. The Oracle Server owner is usually the oracle 
user. At the group level is the dba group. Therefore the oracle group 
becomes redundant because the world level has execute permission 
on all executables. 

28. How does the Oracle Server check that you are in the right group? 
There is a file called config.c located under 

$ORACLE_HOME/rdbms/lib which contains the current dba group. 
This group is compared to the group to which your user-id defaults. 
If there is a match then there is no problem. If there is not a match 
you are asked to relink with the new group (as specified during the 
install) as the dba group. 

29. I already have a database up and running. I would like to change 
the name of the dba group. How do I do this? 

Set up entries in /etc/group and /etc/passwd, then relink the Oracle 
Server kernel. 

Multiple databases 

30. When I want to install a new database with the same executables, do 
I need to run root.sh again? 

No. The Oracle Server files already have the right permissions. 
However, you will need to manually put in an extra entry for your 
new sid in /etc/oratab. 

31. Can I have two different databases using the same set of 
executables? 

Yes. Both of the databases would have the same ORACLE_HOME, 
but each would have a different sid. Note that this is very different 
from creating two separate $ORACLE_HOME directories. The 
latter method usually is a waste of space. 

32. If I create a new database, do I have to create the products' database 
objects? 

Yes. Many products need to have their own tables in the database. 
For example, SQL*Forms expects to see the iapapp table. These 
product-specific tables are created during the individual product 
installs. 

Use the "Create new DB objects" option of the Installer's Install 
Actions menu. 
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33. I forgot the value of my ORACLE HOME and sid. They are not 
defined in my environment. How can I find out what they are? 

You can look in /etc/oratab. There should be an entry for your sid 
(provided you ran root.sh or had manually put the entry in there 
previously). 

Alternatively, you can look for the SQL*DBA executable since you 
know it is in $ORACLE_HOME/bin. Although you do not know 
where the Oracle home directory is, you can find it by searching for 
the sqldba executable using the following command: 

$ find / -name sqldba -print 

This command returns a full path name for SQL*DBA. 

On some systems you can also enter which sqldba at the system 
prompt. This returns the pathname, provided your environment 
variable $PATH contains $ORACLE_HOME/bin as one of its 
components. 

34. After installation, is my database set up for media or instance 
recovery? 

The database is created in noarchivelog mode, which means that 
archiving is not enabled. You can enable it after installation using 
SQL*DBA. Refer to the "Log Archiving" chapter for more 
information on setting up redo log archiving. 

35. I would like to put my database in archive mode but 1 do not have 
enough space to store the archive logs. What should I do? 

Many UNIX platforms support archiving to tape. This uses a special 
process called archmon. For more information, please see the "Log 
Archiving" chapter. 

Utilities 

36. What is the make utility? 

The make utility is a command generator in UNIX. When Oracle 
Server executables need to be "remade," they essentially need to be 
compiled and linked with many libraries. The make utility 
automates this process. 

37. Can I manually remake the Oracle Server without running the 
Installer? 

Yes. Change directories to $ORACLE_HOME/rdbms/lib and enter 
the following command: 

$ make -f oracle.mk oracle 
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This creates a copy of the oracle executable in 
$ORACLE_HOME/rdbms/lib which can then be copied over to 
$ORACLE_HOME/bin. Shut down the database before moving the 
executable. As a last step, change the permission of oracle to 4755 
and make sure that it is owned by the oracle user. 

Note that if you enter: 

$ make -f oracle.mk install 

this generates all of the Oracle Server related executables and moves 
them to $ORACLE_HOME/bin automatically. 

In general, you can relink any products by using the make 
command. The make files are in each product's lib subdirectory. 

38. Is make absolutely essential? 

Yes. The Oracle Server assumes that make is available on client 
machines. Some operating system vendors provide make along with 
the C libraries as a separate developers kit. The Oracle Server 
installation assumes that this developer's kit is installed. See the 
"Hardware and Software Requirements" section in the "Key to 
Oracle on UNIX" chapter of the ICG for more information on the 
specific needs of your operating system. 

39. Does the Oracle Server use make even if we say no to relinking? 

Yes. Products like PL/SQL and SQL*Net drivers will relink by 
default. Even if you do not install these products, the Oracle Server 
installation still uses make. 

40. Is there an online listing of all Oracle Server error messages? 

Yes. You can use the oerr utility. For example, to find the meaning of 
ORA-942, enter: 

$ oerr ora 942 

The information provided is identical to what is available in the 
documentation, including the reason why the error occurred and a 
recommended course of action. You can also look up other classes of 
error (such as iad or iag) in this manner. 

41. What is ranlib? 

This is a utility available on BSD or hybrid UNIX systems, which 
generates a table of contents for each archive library. Warning 
messages about libraries having no symbol table are normal and 
harmless. 

42. What is orasrv? 
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This is a listener process that listens for client connections via 
TCP/IP VI.0. When it receives a connection request, it forks off a 
background process for the client process and then goes back to 
listening for connections. With SQL*Net V2.0, tnslsnr performs this 
task. 


RDBMS scripts 

43. Which script creates the data dictionary views? 

When the Installer is run, it first calls crdbs/d.sql to issue the create 
database command. Then it runs crdb2s/d.sql to perform all of the 
other initiation of the database, including calling the catalog.sql 
script. The catalog.sql script, which is located in the 
$ORACLE_HOME/rdbms/admin directory, creates the data 
dictionary views. This script is run as the Oracle Server user sys. 

44. Which script creates the import/export views? 

The expvew.sql script, which is located in the 
$ORACLE_HOME/rdbms/admin directory, creates the 
import/export views. If your import or export fails with the error 
message "table or view does not exist," chances are that expvew.sql 
needs to be run. This script is run as the Oracle Server user sys. 

45. What is sql.bsq? 

The sql.bsq file is located under $ORACLE_HOME/dbs and 
contains the actual table definitions that make up the Oracle Server. 
The views that you use as a DBA are based on these tables. This file 
is run when you issue the create database command; it should 
never be modified by the user. 

46. What is utlmontr.sql? 

The utlmontr.sql script is located in 

$ORACLE_HOME/rdbms/admin. This script is typically run as 
sys, and gives users access to SQL*DBA monitor. 

Shell scripts 

47. What are coraenv and oraenv? 

These are shell scripts. The coraenv script runs in the C shell while 
oraenv runs in the Bourne shell. If you have multiple databases on a 
machine, you can put the coraenv script in your .login file (C shell), 
or put oraenv in your .profile file. The script prompts you for the sid 
of your choice when you log in. 
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Remember, your sid determines which database you will access. 
When you have specified a sid, (c)oraenv looks up /etc/oratab and 
sets up your environment variables (such as ORACLE_HOME, 
ORACLE_SID, and PATH.) 

48. What is dbhome? 

The dbhome script is located in the local bin directory. It is called by 
(c)oraenv to determine the correct Oracle home directory for a 
certain sid, by looking up ORACLE_SID in /etc/oratab. 

49. What is read.sh, located in $ORACLE_HOME/orainst? 

This is a simple shell script that prompts you with questions and 
provides you with default answers during the installation. 

50. What is echodo, located in $ORACLE_HOME/bin? 

This is a simple shell script echoes a command and then runs it. 


Files 

init.ora 

51. What is init.ora? 

The init.ora file is a parameter file used to start up the database. You 
can modify the parameters in this file to tune your database 
according to your needs. The init.ora template is copied to 
initsid.ora for each database. It is the inits/d.ora file that affects your 
database. 

For the OFA configuration, the init.ora file is found in 
ORACLE_BASE/admin/tfbnamc/pfile/inits/Vf.ora. For other 
configurations, it is found in ORACLE_HOME/dbs/inits/d.ora. For 
more information on the init.ora file, please see the Tuning section 
in the "System Administration" chapter of the ICG. The default 
values of the init.ora file are listed in Chapter 4 of the present 
manual. 

Control files 

52. How many control files do I get when I create the database? Should 
I have more? 

By default you get three control files. When using the OFA 
configuration, these are in the $ORACLE_BASE/data/rffrw7mc 
directory, called cntrls/d.dbf, depending on what the sid is. With 
alternate configurations, the three control files are located in 
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$ORACLE_HOME/dbs/cntrls/tf.dbf. These are all located on the 
same disk, and you should move them to separate disks, if possible. 

To create additional control files, use the following procedure: 

SQLDBA> connect internal 
SQLDBA> shutdown 

At the operating system level: 

$ cp $ORACLE_HOME/dbs/cntrlsid.dbf /usr3/oracle/cntrlsid.dbf 

Edit your inits/d.ora to include the new control file in the 
control_files parameter. 

SQLDBA> connect internal 
SQLDBA> startup 

Trace and alert files 

53. What are the *.trc files? 

These are called 'Trace" files; they contain diagnostic information 
about the database as it is running. Each server and background 
process (pmon, smon, and so on) can write to an associated trace 
file. 

These files are created only when there is relevant diagnostic 
information or internal errors to report. Therefore, you will 
probably not see a trace file for each of the background or server 
processes. 

All trace files for background processes and the ALERT file are 
written to the destination specified by the initialization parameter 

background_dump_dest. It defaults to 
$ORACLE_HOME/rdbms/log. 

All trace files for server processes are written to the destination 
specified by the initialization parameter user_dump_dest. It also 
defaults to $ORACLE_HOME/rdbms/log. 

54. What is the alert file? 

This file maintains a complete history of the database since its 
creation. The information that is in this file relates to DBA activities 
such as startup and shutdown times, database architecture changes 
(adding or dropping tablespaces and rollback segments), and any 
internal Oracle Server errors. The DBA should look at this file 
regularly and make sure that no error messages show up. 
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Database files 


55. I already have a database running, but 1 want to move my data file 
to a different partition because I want to get some space. Can I do 
this? 

Yes. Use the following procedure to copy the file: 

SQLDBA> connect internal 
SQLDBA>shutdown normal 
SQLDBA>exit 
$ cd $ORACLE_HOME/dbs 

$ mv $ORACLE_HOME/dbs/dbsid.dbf /usr3/oracle 
SQLDBA> connect internal 
SQLDBA> startup mount 

SQLDBA> alter database rename file '?/dbs/dbssid.dbf' to 
'/usr3/oracle/dbssid.dbf' ; 

SQLDBA> alter database open 

56. Can 1 rename my log files like this also? 

Yes. 

Logfiles 

57. How do install scripts remember user input from the previous 
install session? 

This information is stored in a file called usrdfl.log located in 

$ORACLE_HOME/orainst. 

58. Will I always get a log file when installing products? 

Yes: it is named $ORACLE_HOME/orainst/install.log. 

Naming conventions 

59. Does it really matter what names I give to my database and log 
files? I don't remember what my database and logfiles are called. Is 
there a way for me to find them? 

The answer to the first part is no. It is a good idea to have some 
convention so that you can find them if you need to. For example, 
use .dbf as an extension. If you forget the names you gave you can 
go into SQL*DBA as the DBA and do the following: 

To find out the names of your database files: 

SQLDBA> select * from dba_data_files; 

To find the name of the log files: 

SQLDBA> select * from v$logfile; 
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/etc/oratab file 


60. What is the oratab file? 

The oratab file is a database directory that works with SQL*Net vl 
protocols. (The SQL*Net v2 equivalent to this directory is found in 
the listener.ora file.) The oratab file is owned by root, and is created 
and updated by the root.sh script. Entries in the file appear in the 
following format: 

A:/usr/oracle:Y 

The first component is the sid, the second is the ORACLE_HOME 
directory for that database, and the third component indicates 
whether the database should be started up on operating system 
reboot. Note that setting this last field to Y is not the only step 
involved in starting up the database: you also need to add a 
command to your startup file. 

If an oratab file does not already exist, the root.sh script creates one 
and adds the entry. If the oratab file exists, the root.sh script 
appends the new entry to the end of the file. If an entry for that sid 
already exists in the oratab file, the root.sh script comments that 
entry out and puts the new entry at the end of the file. 

Note: The directory in which the oratab file resides is 
platform-specific. On most UNIX-based systems this file is 
/etc/oratab. On SVR4 systems, this file may be 
/var/opt/oracle/oratab. Check your ICG for information specific 
to your platform. 

listener.ora file 

61. What is the listener.ora file? 

The listener.ora file is used with SQL*Net v2 adapters. (The 
SQL*Net vl equivalent to this directory is found in the /etc/oratab 
file.) It defines listening end points for the generic TNS listener, 
defines mappings of ORACLE_SIDs to ORACLE_HOMEs, and 
defines listener DBA-task passwords. Every TNS listener requires 
this file. 


Permissions 

62. If I am concerned about permissions on certain files, which ones are 
really important? 

The most crucial are the oracle, orasrv, orapasswd, and tnslsnr 
executables in the $ORACLE_HOME/bin directory. 
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The oracle executable should be rwsr-xr-x owned by the oracle user. 
To set these permissions, use the following command: 

$ chmod 4755 oracle 

In SQL*Net VI the orasrv executable should be rws--x--x owned by 
root. To set these permissions, use the following command: 

# chmod 4751 orasrv 

The orapasswd executable should be 700 and owned by the oracle 
user. The password files should be 644 and owned by the oracle 
user. 

To set these permissions, use the following command: 

# chmod 700 orapasswd 

tnslsnr 

Note also that if you have bought the SQL*Net v2 Oracle SPX/IPX 
Adapter, you must also set permissions for ntisbsdm, the SPX/TLI 
service broadcast daemon. , 

The ntisbsdm executable should be rwsr-xr-x owned by root. To set 
these permissions, use the following command: 

# chmod 4755 ntisbsdm 


Miscellaneous 

63. How do I relink? 

Use the Installer. 

64. What are the libxxx.a files located in various directories? 

These are the libraries that contain the executable versions of the 
Oracle Server source code. The compiled programs are archived into 
libraries using the ar command. 

65. What is the $ORACLEJTOME/lib directory? 

This is the centralized location where the public libraries reside. 
Libraries private to a particular product will be located under the 
product/ lib subdirectory. 

66. How do 1 know which files are associated with which product? 

Under every product/ install directory there is a product. map file. For 
example, there is a file called sqlplus. map under 
$ORACLE_HOME/sqlplus/install. This .map file lists all the files 
that are needed by that product. 
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67. I am very interested in increasing the performance of my database. 
Where will I find more information about tuning? 

The Oracle Server Administrator's Guide provides steps for tuning 
your database's overall performance, and the Oracle Server 
Application Developer's Guide gives instructions for tuning SQL 
statements and complete applications. 

The "Tuning" section in the "System Administration" chapter of the 
ICG also provides information on tuning the Oracle Server for 
UNIX. 

68. How do I start investigating the use of shared memory segments 
and semaphores at a UNIX level? 

Refer to the commands ipcs and ipcrm. The ipcs -b command is 
very useful. It shows the shared memory and semaphores currently 
in use. 

The "Semaphores" section in the "System Administration" chapter 
of the ICG provides a discussion of semaphores and semaphore 
parameters. The "Shared Memory" section in the "Key to Oracle on 
UNIX" chapter of the ICG discuss shared memory segments and 
suggested parameter values. 

69. Can I set up some of my datafiles to be raw devices and some of 
them to be regular UNIX files? 

Yes. the Oracle Server treats them transparently. In fact, using raw 
devices is one way to increase database performance, since it 
eliminates the UNIX buffer cache. See the "Raw Devices" section in 
the "System Administration" chapter of the ICG for more 
information on using raw devices on your platform. 

70. Can I have multiple datafiles on one raw device? When creating the 
tablespace with a raw device, what size should I specify for the raw 
device? 

A single raw device can only function as one Oracle Server datafile. 
If you have a large raw disk and want to use it with two different 
tablespaces, repartition it. We recommend that you specify the 
datafile size to be slightly less than the size of the raw device for 
operating system overhead purposes. 

71. How can I keep track of virtual memory on my machine? 

Different machines use different utilities. BSD-based versions of 
UNIX use vmstat while System V-based versions use sar. See your 
operating system documentation for more information. 







72. What is the minimum amount of disk space that the data dictionary 
needs to survive? 

The data dictionary needs approximately 5-6 MB (database files) to 
survive. We do not recommend that you push this lower limit, since 
you also need space to store your data. 


Executables 

General 


73. What do all the executables in the $ORACLE HOME/bin directory 
refer to? 

These are all the executables created by the different Oracle 
products. Each one is described in its respective product 
documentation. 

74. What is the setuid bit? 

The setuid bit is the s bit set for the oracle and orasrv executables. 

By setting oracle to permissions 4755, you will ensure that any 
process executing oracle will have its effective uid be that of oracle. 

75. I noticed that I have executables called oracleO, sqldbaO, etc., in 
$ORACLE_HOME/bin. What are these? 

During relinking, the install scripts saves old versions of the 
executables with an O appended to the end of the file name. For 
example, the oracle executable would be saved as oracleO. These 
old executables can be removed if everything works fine. 

76. When I do an Is -1 in $ORACLE_HOME/bin, some of the 
executables (such as iac and iag) are the same size. Is this intended? 

Yes. These kinds of executables are usually links of each other. 

They are made using the In command in UNIX. 

77. I am missing the SQL*DBA executable in $ORACLE_HOME/bin. 
How can I get it? 

The SQL*DBA executable (and other kernel related executables) can 
be generated on site by using the following command: 

$ make -f oracle.mk executable_name 

The above command has to be run in $ORACLE_HOME/rdbms/lib. 
The executables have to then be manually moved to the 
$ORACLE_HOME/bin directory. To automate this process, enter: 

$ make -f oracle.mk install 
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This generates all of the Oracle Server related executables and 
moves them to $ORACLE_HOME/bin automatically. 

Note: You can also generate any product executable in this way. 
Simply use the appropriate product.mk file in the above command. 

78. Does the above command also replace the old executable in the 
$ORACLE_HOME/bin directory? 

If you use the install target (make -f oracle.mk install) then an 
attempt is made to replace the executables. Otherwise only a local 
copy is created in the current working directory. 

osh and ulimit 

79. Some UNIX platforms have an executable called osh in 
$ORACLE_HOME/bin. What is that? 

This is an executable that raises the ulimit for your current login 
session. The ulimit essentially defines the maximum file size on 
your machine. 

See the "System Administration" chapter of the ICG for more 
information on the ulimit parameter. Note that the ulimit 
parameter and osh may not apply to your platform. 

80. How is osh created? 

The osh executable is created by compiling a file called osh.c in 
$ORACLE_HOME/rdbms/admin. You can always make a new 
copy of osh by executing the following command from the 

$ORACLE_HOME/rdbms/admin directory: 

$ cc -o osh osh.c 

You can then move this to the bin directory. The osh executable 
should be owned by root and its permissions should be rws-x-x. 
To set the correct permissions enter the following: 

$ chmod 4711 osh 

81. Is the ulimit set every time I log in to my UNIX account? 

Yes, osh is actually executed from within your .profile (.login in the 
C Shell). The .profile (.login) calls oraenv (coraenv) which in turn 
calls osh. 

Tools 

82. How can I tell which network drivers I have already installed? 
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In SQL*Net VI you can check a file called osntab.c located in 
$ORACLE_HOME/rdbms/lib. This file gives you an indication of 
what has already been installed. Alternatively, you can run strings 
on the executable and look for the net driver. 

To check if the Oracle Server has been relinked with this driver, do 
the following in the $ORACLE_HOME/bin directory: 

strings oracle I grep TASK 

Likewise, to check if a tool like SQL*Plus has SQL*Net TCP/IP 
linked in, enter: 

strings sqlplus I grep task 

If TCP_TWO_TASK shows up in the output, then the program can 
accept or initiate SN TCP connections. 

In SQL*Net V2 there is no separate executable for most adapters; 
only SPX/IPX has its own executable. You can use the adapters 
utility, which is described in the "SQL*Net Overview" chapter of the 
TARG, to determine which adapters are installed, or linked in to a 
particular product. For example, 

$ adapters $ORACLE_HOME/bin/sqlplus 

displays the adapters which are linked with SQL*Plus. 

83. I have just installed a SQL*Net driver. Is there a way for me to test it 
without having the client installed? 

Yes, you can do what we call a loopback, meaning we loop back 
onto the server machine using SQL*Net. For example, when testing 
SQL*Net TCP/IP, enter the following: 

$ sqlplus username/password@t: myhost:sid 

where myhost is the name of the server. If this works, then chances 
are that you are doing fine. 

84. After installing SQL*Forms, I get an ORA-942 error when I try to 
enter SQL*Forms. Why? 

SQL*Forms is one of a few products (including SQL*Menu and 
SQL*ReportWriter) that rely on the presence of certain base tables. 
These tables are created during the product installation. If these 
tables are missing, you get the message "ORA 942 - table or view 
does not exist." The scripts for creating these tables are located in 
$ORACLE_HOME/ product /admin. 

85. What is UTD? 
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UTD stands for Universal Terminal Definition. Up until now, we 
have had separate keyboard mappings for each product. For 
example under VT100, the "Help" key for SQL*Menu may be FI 
while under SQL*Forms, it is [HELP]. This has caused some 
confusion for people who use many products. UTD was set up to 
make the key mappings consistent. With UTD, a user only has to 
remember twelve keys. 

UTD also provides consistency for using many different keyboards, 
since all you have to remember is 12 keys. This utility is described in 
detail in the TARG. 

86. What are the key Oracle environment variables? 

EDITOR default editor 


HOME 

home directory 

HOST 

host name 

LD LIBRARY 
PATH 

contains the location of the dynamic shared libraries 
used by the Oracle Server. This variable is used only 
for some SVR4 platforms. 

LOGNAME 

login ID 

ORACLE_BASE 

the Oracle Server home directory for the OFA 
configuration. Used during installation. 

ORACLE_HOME 

the Oracle Server home directory 

ORACLE 

LPARGS 

options to print, command which is described 
below 

ORACLE 

LPPROG 

indicates the print command used for Oracle Server 
applications 

oracle_sid 

Oracle system identifier 

ORACLE_TERM 

is the terminal definition resource file. If not set, it 
defaults to the $TERM variable 

ORACLE 

TERMINAL 

tells SQL*DBA where to find the Toolkit II resource 
files for full screen character mode. Do not set this 
variable when you are running the Installer. 

ORAKITPATH 

path for resource files 

PATH 

search path for files 

PWD 

present directory 

SHELL 

current shell (csh = C shell, sh = Bourne shell, ksh 
= Korn shell) 
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TERM 

terminal setting 

TNS_ADMIN 

points to various SQL*Net V2.0 configuration files. 
It is used most often with the Interchange. 

TWO_TASK 

two-task driver 

TZ 

time zone variable 

USER 

user ID 
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APPENDIX 



Environment Variables 


T his appendix describes Oracle environment variables specific to 
UNIX; it also describes the UNIX environment variables that affect the 
Oracle Server. 
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Oracle Environment Variables on UNIX 


The following are Oracle for UNIX environment variables. 


Additional Information: Not all UNIX platforms use all of 
qZk these environment variables. For more information on which 
environment variables are specifically for your UNIX platform, 
see your Installation and Configuration Guide. 

BOOKJLOCALPREFERENCE 


Function 

Syntax 

Example 

BOOK_RESOURCE 

Function 

Syntax 


Specifies the location of the Oracle*Book local 
preferences file; this variable is optional and over¬ 
rides the default locations for this file 

directoryjxame 

$ORACLE_HOME/book/tk2/admin 


Specifies the directory path for Oracle*Book re¬ 
source files; this variable is optional and overrides 
the default locations for this file 

directory jxame 


Example 

BOOK_GLOBALPREFERENCE 

Function 


$ORACLE_HOME/book/admin/resource/US 


Specifies the location of the Oracle*Book global 
preferences file; this variable is optional and over¬ 
rides the default locations for this file 


BOOK.HELP 


Syntax 

directory jxame 

Example 

$ORACLE_HOME/book/admin 

Function 

Specifies the directory path containing 
Oracle*Book help files; this variable is optional 
and overrides the default locations for this file 

Syntax 

directoryjpath 

Example 

$ORACLE_HOME/book/admin/help/US 
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CASE_HOME 


Function 

Syntax 

Example 

CASE_HP_CMD 

Function 

Syntax 

Example 

CASE_PS.CMD 

Function 

Syntax 

Example 

CASE_RESOURCE 

Function 

Syntax 

Example 

CASE_SDPRINT 

Function 

Syntax 

Example 

CGENJTOME 

Function 

Syntax 

Example 


Specifies the path to the CASE*Designer directory 
directoryjpath 

$ ORACLE_HOME/cde s 


Specifies the HPGL plotter command that 
operates on a CASE*Designer file generated by 
the Output command 

the shell command used to print to the plotter 

lpr -Pplot 


Specifies the Postscript printer command that 
operates on a CASE*Designer file generated by 
the Output command 

lpr -P printer 

lpr —Ppsl 


Specifies the terminal definition file used with 
CASE products. If not specified, the default 
Oracle Terminal resource file is used. 

fileidevice 

where file is file. r from 
$ORACLE_HOME/dict50/admin/etc and 
device is a device name from within that file 

case_hpx:xterm 


Specifies the printer device for performing a 
screen dump when using CASE*Designer 

printerjname 

lw 


Specifies the path to the CASE*Generator home 
directory 

directory jpath 

$ORACLE_HOME/cgen2 0 
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FONT DIR REMOTE 


Function 


Syntax 

Example 

FORMS30PATH 

Function 

Syntax 

Example 

MENU5PATH 

Function 

Syntax 

Example 


NLSJLANG 


ORACLE_BASE 


Function 

Syntax 

Example 


If set to T, will prevent CASE*Designer from 
checking the current X server font paths for a di¬ 
rectory containing CASE fonts, and trying to add 
the default shipped font directory to the current 
font patch. Used where CASE fonts are made 
available to the X server before CASE*Designer is 
invoked. 

directory _path 

/usr/oracle/cdes/admin/fonts/case_l.1 


Specifies a list of directories containing Toolkit I 
terminal description (.r) files. Used by 
SQL*Forms 3.0 to find Toolkit I resource (.r) files 

colon-separated list of directories 
directory directory’.directory 

$ORACLE_HOME/forms30/admin/resource: 
$ORACLE_HOME/menu5/admin/resource:. 

Note: The final period in the preceding example 
refers to the current working directory. 


Specifies a list of directories containing Toolkit I 
terminal description (.r) files. Used by Menu 5.0 
to find Toolkit I (.r) resource files. 

colon-separated list of directories 
directory directory directory 

$ORACLE_HOME/menu5/admin/resource: 
$ORACLE_HOME/forms30/admin/resource:. 

Note: The final period in the preceding example 
refers to the current working directory. 


Specifies which language and character set is used 
for output. See ICG for the range of values. 

la ng uageJerri to ry. cha racterset 

french_franee.we8dec 
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Function 


Syntax 

Example 

ORACLE J3ELP 

Function 

Syntax 

Example 

ORACLE JIOME 

Function 

Syntax 

Example 

ORACLE.LPARGS 

Function 

Range of Values 
Example 

ORACLE_LPPROG 

Function 

Syntax 

Range of Values 


If set during installation, then orainst will use 
ORACLE_BASE conventions for locating files 
during installation and will use the value of 
ORACLE_BASE as the base directory for 
installation. See the "Preparing to Install Oracle 
Products" section of the ICG. 


Specifies the directory containing help files 


Specifies the directory containing the Oracle soft¬ 
ware distribution. For more information, see 
the ICG. 

directory _path 

/uOl/oracle/product/7.1.3 


Specifies the correct arguments for the command 
set in ORACLEJLPPROG. Used by Easy*SQL, 
SQL*Calc, SQL*Forms, SQL*Menu, SQL*Report, 
and SQL* Report Writer. 

see the man pages for the command set in 

ORACLE.LPPROG 

-P dest _printer 


Specifies the UNIX command used to print on the 
user's system. Used by Easy*SQL, SQL*Calc, 
SQL*Forms, SQL*Menu, SQL*Report, and 
SQL*Report Writer. 

command 

lp, lpr, print or other print commands used by 
user's system 


directory _path 

/uOl/oracle 


directory jpath 

$ORACLE_HOME/help/admin/resource 


Example x p 

ORACLE.LPSTAT 
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Function 

Syntax 

Range of Values 
Example 

ORACLE_PAGER 

Function 

Syntax 

Range of Values 
Example 

ORACLE.PATH 

Function 

Syntax 

Example 


Specifies the command used to query the printer 
queue. 

command 

lpstat, lpq or any other printer status command 
used by the user's command 

lpq -P dest_printer 


Specifies the UNIX pager to be used by Oracle 
products such as SQL*Menu 

command 

more, less, pg or any pager command available 
on the user's system 

more 


Specifies the search pathname for files used by 
SQL*Forms v3, SQL*Menu v5, and SQL*Plus. 
Should be set to the directories containing forms, 
menus, and scripts. 

colon-separated list of directories 
directory-.director}/directory 

/u01/oracle/adhoc/forms30: 

/uOl/oracle/adhoc/menu5:. 


Note: The final period in the preceding example 
refers to the current working directory. 

ORACLE_SID 

Function Specifies the Oracle System Identifier 

Syntax The string of numbers and characters must begin 

with a letter (by convention, all letters are upper 
case). For more information, see the ICG. 

Example salesi 
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ORACLEJTERM 


ORACLE.TERMINAL 


ORACLE.TRACE 


ORAENV.ASK 


ORAKITPATH 


Function Specifies the terminal type identifier. Used by 

SQL*DBA, orainst, CDE tools in character mode 
to determine the correct Toolkit II (.res) resource 
file. 

string of characters 

The value of this variable must be set such that the 
pattern tk2c${ORACLE_TERM}.res corresponds 
to valid resource files in the Toolkit II resource 
directory or directories. See the ICG for a list of 
valid values. 

Example vtioo 


Syntax 

Range of Values 


Function 

Syntax 

Example 


Specifies an additional directory to be searched 
for Toolkit II (.res) resource files 

directory _name 

$ORACLE_HOME/tk2 /admin/terminal 


Function Turns on tracing of Bourne shell scripts during 

install. If set to T, then many of the Oracle shell 
scripts will run with set-x flag on. 

Range of Values T or anything else 


Function Controls whether (c)oraenv prompts for 

$ORACLE_SID or $ORACLE_HOME. If set to 
NO (c)oraenv does not prompt and, if set to any¬ 
thing else, it does. 

Syntax string 

Range of Values NO or anything else 


Function Specifies a list of directories containing Toolkit I 

resource files which are used by Forms 3, Menu 5, 
and oraterm as a fallback search path of the re¬ 
source files; if the .r file cannot be found using 
FORMS30PATH, MENU5PATH, and 
ORAKITPATH, respectively. 

Syntax colon-separated list of directories 

directory-.directory-.directory 
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ORAMAILJEDITOR 


ORATERMPATH 


sdd.bin 


SDD.HOME 


SDD_PRINT 


SDD.WPRINT 


Range of Values directory with valid .r files 


Example 


$ORACLE_HOME/oraterm/admin/resource: 
$ORACLE_HOME/forms30/admin/resource: 
$0RACLE_H0ME/menu5/admin/resource:. 


Note: The final period in the preceding example 
refers to the current working directory. 


Function 

Specifies the editor used by Oracle*Mail for the 
Invoke Editor menu option 

Syntax 

editor_name 

Example 

vi 

Function 

Specifies a list of directories containing Toolkit I 
terminal description (.r) files. Used by oraterm to 
find Toolkit I (.r) resource files 

Syntax 

colon-separated list of directories 
directory‘.directory-.directory 

Example 

$ORACLE_HOME/oraterm/admin/resource: 
$ORACLE_HOME/menu6/admin/resource 

Function 

Specifies the path to the directory containing 
binary executables 

Syntax 

directory_path 

Example 

$ ORACL E_HOME/bin 

Function 

Specifies the path to the directory containing top 
level CASE Dictionary directories 

Syntax 

directory _path 

Example 

$ORACLE_HOME/dict50/admin 

Function 

Specifies the command used to print 80 column 
(portrait) reports from CASE Dictionary 

Syntax 

print_command 

Range of Values 

lp, lpr 

Example 

lp -Pportrait 
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Function 


Syntax 

Range of Values 
Example 

SQLPATH 

Function 

Syntax 

Example 

SRWJTMP 

Function 

Syntax 

Range of Values 
Example 


Specifies the command used to print 132 column 
(landscape) reports from CASE Dictionary 

printjcommand 

lp, lpr 

lpr -Plandscape 

Identical to ORACLE_PATH. This variable has 
been obsoleted by ORACLE_PATH; users should 
use ORACLE_PATH in new code. 

comma-separated list of directories 
directory-.directory-.directory 

/u01/oracle/adhoc/forms30: 
/u01/oracle/adhoc/menu5:. 

Note: The final period in the preceding example 
refers to the current working directory. 


Specifies the directory used by SQL*ReportWriter 
for temporary files 

directory jpath 

any directory with >10 Mb of disk space 

/uOl/oracle/tmp 


TNS_ADMIN 

Function Sets the directory containing the SQL*Net version 

2 configuration files 

Syntax directory_path 

Range of Values any directory; for more information, see the ICG 

Example /u01 / oracle / admin/ SQLNET / 2 0 
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TWO TASK 


Function 

Syntax 

Range of Values 


Example 


Sets the default SQL*Net version 1 connect string 
or SQL*Net version 2 connect string descriptor 
alias defined in tnsnames.ora. 

available connect string 

For version 1: any valid version 1 alias defined in 
tnsnames.ora. Refer to the ICG for a list on your 
platform and the syntax of each one. 

For version 2: any valid version 2 alias defined 
in tnsnames.ora 

t:host:oracle 
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UNIX Environment Variables that Affect the Oracle Server 

The following UNIX environment variables may need to be properly 
configured to work with the Oracle Server. Not all ports use these 
environment variables. See your operating system documentation. 


ADA_PATH 

DISPLAY 


Function 


Function 


Syntax 


Example 


HOME 


Function 

LANG or LANGUAGE 


Function 


LDOPTS 

LPDEST 


LDPATH 


Function 

Function 

Syntax 

Example 

Function 


Specifies the directory containing the 
Ada compiler 


Used by X-based tools. Specifies the display de¬ 
vice used for input and output. See vendor's X 
Windows documentation for details. 

hostnameidisplay 

hostname is the network identifier for the display 
device; display is a number which is almost 
always 0 

135.287.222.12:0 
bambi:0 


The user's home directory 


Specifies the language and character set used by 
the operating system for messages and 
other output. See the operating system documen¬ 
tation, and your ICG. 


Specifies the default linker options on some plat¬ 
forms. See man pages on Id for details. 


For System V-based systems, used to specify the 
user's default printer 

printerjname 

docqms 


Default directories used by the linker to find 
shared object libraries See man pages on Id for 
details 
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LD_LIBRARY_PATH 


Function 

Used on some platforms by the shared library 
loader (ld.so) at runtime to find shared object li¬ 
braries See man pages on ld.so for details. 

Syntax 

colon-separated list of directories 
directory’.directory‘.directory 

Example 

PATH 

/usr/lib:$ORACLE_HOME/lib 

Function 

Used by the shell to locate executable programs; 
needs to include $ORACLE_HOME/bin 

Syntax 

colon-separated list of directories 
directory'.directory‘.directory 

Example 

/bin:/usr/bin:/usr/local/bin: 

/usr/bin/Xll:$ORACLE_HOME/bin:$HOME/bin:. 

PRINTER 

Note: The final period in the preceding example 
refers to the current working directory. 

Function 

For BSD-based systems, used to select the default 
printer for a user 

Syntax 

Example 

SHELL 

printerjname 

docqms 

Function 

Specifies the command interpreter used during a 
host command 

Syntax 

Range of Values 

shell pathname 

/bin/sh or /bin/csh or /bin/ksh or 

any other command interpreter supplied with 

the user's system 

Example 

TERM 

/bin/sh 

Function 

Used by Oracle Toolkit II character mode tools to 
determine the type of terminal being used; also 
used by many UNIX tools for the same purpose 

Example 

vtlOO 


B -12 


Oracle7 for UNIX 








TMPDIR 


XENVIRONMENT 


Function 

Specifies the default directory for temporary disk 
files; if set, tools that create a temporary file do so 
in this directory 

Syntax 

directory __path 

Example 

/u02/oracle/tmp 

Function 

Specifies a file containing X Windows system re¬ 
source definitions. See the vendor's documenta¬ 
tion for the X Windows system. 
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create tablespace command, storage clause, 4 - 
8 

cursors, 1-19 

D 

c 

call stack trace. See trace files 

CASE, B - 3 

CASE*Designer, B - 3, B - 4 

CASE*Dictionary, B - 8, B - 9 

C A S E * G e n e r a t o r, B - 3 

CASE_HP_CMD, B - 3 

CASE_PS_CMD, B - 3 

CASE_RESOURCE~, B - 3 
case_sdprint, B - 3 

catalog.sql, common questions, A - 12 
catching routine, example of, 2-26 

CDE tools, B - 7 

CGENJKOME, B - 3 
changing databases, 2-3 
checkpoint, 3-10 
checkpoint process, 1-23 
chmod command, example, 2-12 
client/server, issues, 5-14 
command interpreter, B - 12 
configuration file, default path, 1-36 
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